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PREFACE 



This publication provides, for reference 
purposes, a detailed definition of the 
machine functions performed by systems 
operating in the System/370 extended- 
architecture (370-XA) mode. 

The publication applies only to systems 
operating in the 370-XA mode. The IBM 
System/370 Pri nci pies of Qperati on , 
GA22-7000, should be consulted regarding 
the functions of the architecture which 
apply to systems operating in the 
System/370 mode. 

The publication describes each function 
at the level of detail needed to prepare 
an assemblei — language program that 
relies on that function. It does not, 
however, describe the notation and 
conventions that must be employed in 
preparing such a program, for which the 
user must instead refer to the appropri- 
ate assemblei — language publication. 

The information in this publication is 
provided principally for use by 
assemblei — language programmers, although 
anyone concerned with the functional 
details of systems operating in the 
370-XA mode will find it useful. 

This publication is written as a refer- 
ence and should not be considered an 
introduction or a textbook. It assumes 
the user has a basic knowledge of data- 
processing systems. IBM publications 
relating to systems operating in the 
370-XA mode are listed and described in 
the IBM System/370 , 30xx , and 4300 
Processors Bibli ographv , GC20-0001. 
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discussed in this publi- 
necessarily available on 
Furthermore, in some 
definitions have been 
allow for some degree of 
and therefore certain 
capabilities may be described or implied 
that are not offered on any model. 
Examples of such capabilities are the 
use of a 16-bit field in the subsystem- 
identification word to identify the 
channel subsystem, the size of the CPU 
address, and the number of CPUs sharing 
main storage. The allowance for this 
type of extendi bi 1 i ty should not be 
construed as implying any intention by 
IBM to provide such capabilities. For 
information about the characteristics 
and availability of facilities on a 
specific model, see the functional chai — 
acteri sties publication for that model. 
The availability of facilities is summa- 
rized in the IBM System/570 System 
Summary : Processors , GA22-7001. 

Largely because this publication is 
arranged for reference, certain words 



and phrases appear, of necessity, earli- 
er in the publication than the principal 
discussions explaining them. The reader 
who encounters a problem because of thi s 
arrangement should refer to the index, 
which indicates the location of the key 
descri pti on . 

The information presented in this publi- 
cation is grouped in 17 chapters and 
several appendixes: 

Chapter JL, Introducti on , highlights some 
of the major facilities of systems opei — 
ating in the 370-XA mode. 

Chapter 2, Organi zati on , describes the 
major groupings within the system — the 
central processing unit (CPU), storage, 
and input/output -- with some attention 
given to the composition and character — 
i sties of those groupings. 
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interruptions* input/output interrup- 
tions* and restart interruptions. 

Chapter 7, General Instructi ons > 
contains detailed descriptions of 
logical and binary-integer data formats 
and of all unprivileged instructions 
except the decimal and floating-point 
i nstructi ons. 



Lists of the instructions arranged 
in several sequences 

A summary of the condition-code 
setti ngs 

A summary of the differences be- 
tween the System/370 and 370-XA 
modes 



Chapter 8, Decimal Instructi ons , 
describes in detail decimal data formats 
and the decimal instructions. 

Chapter j>> Floati ng-Poi nt Instructi ons * 
contains detailed descriptions of 
floating-point data formats and the 
floating-point instructions. 

Chapter 10 * Control Instructi ons * 
contains detailed descriptions of all of 
the semi pri vi leged and privileged 
instructions except for the I/O 
i nstructi ons. 



Chapter 11 * 
describes the 
correct i ng, 
malfuncti ons. 



Machi ne-Check Handli ng * 

mechanism for detecting* 

and reporting machine 



Chapter 12 * Operator Faci 1 i ti es * 
describes the basic manual functions and 
controls available for operating and 
controlling the system. 



Chapters 13-17 of 
provide a detailed 
functions performed 
subsystem and the 
between the CPU and 
tern. 



this publication 

definition of the 
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Chapter 13 * I/O Overvi ew * provides a 
brief description of the basic compo- 
nents and operation of the channel 
subsystem. 



Chapter 14, I/O 
the description 
i nstructi ons. 



Instructi ons * contains 
of the 370-XA I/O 



Chapter 15 * Basi c 
describes the basic 
performed by the 
including the 



I/O 



Functi ons * 

I/O functions 

channel subsystem, 

initiation* control, and 



I conclusion of I/O operations 



Chapter 16 , I/ O Interrupti ons * covers 
I/O interruptions and interruption 
condi tions. 



A table of the powers of 2 

Tabular information helpful in 
dealing with hexadecimal numbers 

An EBCDIC chart 



SIZE NOTATION 



In this publication* 
and G denote the mul 
and 2 30 , respective 
letters are borrowed 
system and stand for 
(10 6 ), and giga (10 9 ) 
the decimal meaning 
sent the power of 
corresponding power o 
ing in this publicati 



the letters K, M, 
tipliers 2 10 , 2 20 , 
ly. Although the 
from the decimal 
kilo ( 10 3 ) » mega 
* they do not have 
but instead repre- 
2 closest to the 
f 10. Their mean- 
on i s as follows: 



Symbol 


Value 


K (kilo) 


1,024 = 2 10 


M (mega) 


1,048,576 = 2 20 


G (giga) 


1,073,741,824 = 2 30 



The following are some examples of the 
use of K, M, and G: 

2,048 is expressed as 2K. 
4*096 is expressed as 4K. 
65,536 is expressed as 64K 

(not 65K). 
2 24 is expressed as 16M. 
2 31 is expressed as 2G. 

When the words "thousand" and "million" 
are used, no special powei — of-2 meaning 
is assigned to them. 



BYTES, CHARACTERS, AND CODES 



Chapter 17 , I/O Support Functi ons , 
describes such functions as channel- 
subsystem usage monitoring, resets, 
initial-program loading, reconfigura- 
tion, and channel-subsystem recovery. 

The Appendixes include: 

• Information about number represen- 
tati on 

• Instruction-use examples 



Although the System/360 architecture was 
originally designed to support the 
Extended Binary-Coded-Decimal Intel — 
change Code (EBCDIC), the instructions 
and data formats of the architecture are 
for the most part independent of the 
external code which is to be processed 
by the machine. For most instructions, 
all 256 possible combinations of bit 
patterns for a particular byte can be 
processed, independent of the character 
which the bit pattern is intended to 
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In this publication, unless otherwise 
specified, the value given for a byte 
denotes a binary value. Thus, when a 
byte is said to contain a zero, the 
value 00000000 binary, or 00 hex, is 
meant, and not the value for an EBCDIC 
character "0," which would be F0 hex. 



OTHER PUBLICATIONS 



The I/O interface is described in the 
publication IBM System/360 and 
System/370 I/O Interface Channel to 
Control Uni t Ori gi nal Egui pment Manufac- 
turers * Informati on , GA22-6974. 

Vector operations aria described in the 
publication IBM System/370 Vector Opei — 
ations , SA22-7125. 

The 370-XA interpretive-execution facil- 
ity is described in the publication IBM 
370-XA Interpret! ve Executi on , 
SA22-7095. 



SUMMARY OF CHANGES 



The following changes, additions, and 
significant clarifications have been 
made to the description of the CPU: 

The definition for INVALIDATE PAGE TABLE 
ENTRY is changed to remove the require- 
ment that the update to the byte of the 
page-table entry be an interlocked 
update. This makes the definition 
consistent with the System/370 defi- 
nition. 

The instruction MOVE INVERSE is included 
as an optional facility. 

The instructions COMPARE AND FORM CODE- 
WORD and UPDATE TREE are included as 
part of the basic architecture. 

Several sections of the document have 
been changed to take the vector facility 
into account. As a result, this publi- 
cation now describes: 

• The effect of reset on the vector 
faci li ty 

• The vector-control bit, control 
register 0, bit 14 



Two new program interruptions: 

Vector operation 

Unnormalized operand 

Two new machine-check interrup- 
tion-code (MCIC) bits: 



Vectoi — facility 
bit 6) 

Vectoi — facility 
bit 13) 



failure (MCIC 



source 



(MCIC 



The following changes, additions, and 
significant clarifications have been 
made to the description of the channel 
subsystem: 

The channel-subsystem timers are no 
longer required to be synchronized with 
the TOD clock. 



The following definitions 
clari f i ed: 



have been 



Channel -sub system- timer synchroni - 
zation when multiple channel- 
subsystem timers exist 

The conditions causing certain 
sequence-code values to be stored 
in the subchannel logout 

The method of terminating an I/O 
operation when the interface- 
control-check condition is recog- 
nized as the result of a device- 
status check 

The circumstances under which the N 
condition (which results from a 
path-not-operational condition) is 
reset 

The conditions which cause the N 
bit to be stored as one in the SCSW 

The transition of a subchannel from 
the start-pending or resume-pending 
state to the subchannel-and- 
devi ce-acti ve or device-active 
state 

The transition of a subchannel from 
the device-active state to a state 
in which the device is not active 



Active allegiance 



• Dedicated allegiance (clarifying 
that command retry is excluded as a 
condition for dedicated alle- 
giance) 

• The actions taken by the channel 
subsystem for a device which is 
operating in multipath mode when 
control unit busy is recognized 

The definition of working allegiance is 
expanded to allow the channel subsystem 
to accept alert status on a path not 



specified by the LPM when the device is 
operating in multipath mode. 

The definition of the clear-pending bit 

now covers the situation in which the 

channel subsystem may be unable to 

determine whether the clear signal was 
issued to the device. 



The meaning of the halt-pendi ng» start- 
pending* and resume-pending bits is 
changed in situations following the 
detection of a channel-control-check 
(CCC) or interface-control-check (IFCC) 
condition while the halt or start func- 
tion is being performed. 
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This publication describes the architec- 
ture of systems operating in the IBM 
System/370 extended-architecture (370- 
XA) mode. 

The architecture of a system defines its 
attributes as seen by the programmer, 
that is, the conceptual structure and 
functional behavior of the machine, as 
distinct from the organization of the 
data flow, the logical design, the phys- 
ical design, and the performance of any 
particular implementation. Several 
dissimilar machine implementations may 
conform to a single architecture. When 
the execution of programs on different 
machine implementations produces the 
results that are defined by a single 
architecture, the implementations are 
considered to be compatible. 



HIGHLIGHTS OF 370-XA 



The 370-XA mode has evolved from the 
System/370 architecture, with special 
attention paid to the implementation of 
large systems. It incorporates a number 
of significant new facilities beyond 
System/370. Some facilities available 
in the System/370 mode are changed or 
not provided in the 370-XA mode. A 
detailed comparison of the differences 
in the facilities and functions which 
are offered in the System/370 mode and 
in the 370-XA mode appears in Appendix 
D. 

The most significant change from 
System/370 is in the I/O facilities 
provided by the channel subsystem . It 
includes these significant new capabili- 
ties: 

• Path-i ndependent addressi ng of I/O 
devices, which permits the initi- 
ation of I/O operations with any 
device without regard to which CPU 
is executing the I/O instruction or 
how the I/O device is attached to 
the channel subsystem. Any I/O 
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Programmable i nterrupti on sub- 
classes , which permit the 
programmed assignment of 1/0- 
interruption requests from individ- 
ual I/O devices to any one of eight 
maskable interruption queues. 

An addi tional CCUi format for the 
direct use of 31-bit addresses in 
channel programs. The new CCW 
format, called format 1, is 
provided in addition to the 
System/370 CCW format, now called 
format 0. The format of the CCWs 
is specified when an I/O operation 
is initiated. 
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• Status-veri f i cat i on faci 1 i tv , which 
reports inappropriate combinations 
of devi ce-svatus bits presented by 
a device. 

• A set of 13 new I/O i nstruct i ons , 
with associated control blocks, 
which are provided for the control 
of the channel subsystem. 

The following is a summary of the other 
extensions incorporated in the 370-XA 
mode: 

• Bimodal addressi ng provides two 
modes of operation: a 24-bit 
addressing mode for the execution 
of old programs and a 31-bit 
addressing mode. The mode is 
controlled by a bit in the PSW, and 
unprivileged instructions are 
provided that examine and set the 
mode. These instructions conven- 
iently permit combining old 
programs, which must operate in the 
24-bit addressing mode, and new 
programs, which can take advantage 
of the 31-bit addressing mode. 

• 31-bi t logi cal addressi ng extends 
the virtual address space from the 
16M bytes addressable with 24-bit 
addresses to 2G bytes 
(2,147,483,648 bytes). In the 
31-bit mode, address arithmetic 
and all logical addresses specified 
by instructions, as well as the 
address appearing in the program- 
status word (PSW), are expanded to 
31 bits. Addresses appearing in 
control regi sters and permanently 
assigned storage locations are 31 
bits, independent of the addressing 
mode. 

• 31-bi t real and absolute addressi ng 
provides addressability for up to 
2G bytes of main storage. Associ- 
ated with this extension, a number 
of formats are changed to provide 
for 31-bit address fields. These 
include the dynamic-address- 
translation and other table 
entries, the associated control 
registers, and the prefix register. 
The 31-bi t-real-and-absolute- 
addressing facility replaces the 
extended- real -addressi ng faci 1 i ty 
of System/370, where page-table- 



entry bits 13 and 14 are used to 
extend the real address to 26 bits. 

The 370-XA protecti on facilities 
reflect the adoption of the 4K-byte 
block as the basic unit of storage 
allocation. Only one storage key 
is allocated to a 4K-byte 
protection block of storage; that 
is, the System/370 2K-byte block is 
not provided. Associated with the 
4K-byte protection block is a 
control, called the fetch- 
protection-override control, that 
eliminates fetch protection for 
locations 0-2047 so as to permit 
access to status and control infoi — 
mation located in the first 2K 
bytes of storage. Page protection, 
which is controlled by a bit in the 
page-table entry, replaces segment 
protection introduced for later 
models of System/370. The page- 
protection facility permits estab- 
lishing read-only pages. As in 
System/370, low-address protection 
provides additional protection for 
the contents of storage locations 
through 511. 
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• The two orders set prefix and store 
status at address provide addi- 
tional capability for communication 
between CPUs by means of the SIGNAL 
PROCESSOR instruction. 

The DIVIDE (DXR) instruction 
provides for an extended-precision 
dividend, divisor, and quotient and 
thus rounds out the set of 
ex t ended- preci sion floating-point 
i nstruct i ons. 

The COMPARE AND FORM CODEWORD and 
UPDATE TREE instructions are 
provided to facilitate sorting 
appl i cat i ons. 

The following is a summary of the facil- 
ities appearing in the System/370 mode 
but not provided in the 370-XA mode: 

• The System/370 I/O i nstruct i ons and 
I/O i nterrupti ons , including all 10 
System/370 I/O instructions, chan- 
nel masks in control register 2, 
the block-multiplexing control in 
control register 0, and channel-set 
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switching with the associated two 
instructions. These facilities are 
replaced by the 370-XA channel 
subsystem. 

The Svstem/370 formats contai ni ng 
24-bi t addresses , which have been 
replaced by formats providing for 
31-bit addresses. These include 
tables and control registers asso- 
ciated with dynamic address 
translation and the dual-address- 
space facility. 

The basi c-control m ode and the 
associated PSW format* as well as 
the controls and information 
formats of the interruption mech- 
anism. In the 370-XA mode* only 
the functions and format of the 
System/370 extended-control mode 
are avai lable . 



optional or unavailable on some models) 
are a standard part of the 370-XA mode. 
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The 2K-bvte block associated with a 
storage key and the instructions 
INSERT STORAGE KEY, RESET REFERENCE 
BIT, and SET STORAGE KEY. 

Pi rect control , including the 
instructions READ DIRECT and WRITE 
DIRECT and the external signals. 
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Similarly, the 370-XA mode includes all 
of the functions (except for DAS 
tracing) of the System/370 dual- 
address-space facility. The 370-XA mode 
thus permits establishing addressability 
for up to 65,536 address spaces of 2G 
bytes each. A number of control- 
register and table formats, however, are 
changed to accommodate the 31-bit 
address fields. 

The System/370 multiprocessing facili- 
ties, which include prefixing, CPU- 
address identification, CPU signaling 
and response, and TOD-clock synchroniza- 
tion, are a basic part of the 370-XA 
mode. Thus, the instructions SET 
PREFIX, STORE PREFIX, STORE CPU ADDRESS, 
and SIGNAL PROCESSOR are operative even 
when no other CPU is in the configura- 
tion. 
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COMPATIBILITY AMONG SYSTEMS IN 370-XA 
MODE 



Except for the facilities specifically 
identified as not provided, the 370-XA 
mode includes all facilities that are 
defined in the System/370 Pri nci pies of 
Operation . Most of the facilities that 
are considered features in the 
System/370 mode (because they are 



Although systems operating in the 370-XA 
mode may differ in implementation and 
physical capabilities, logically they 
are upward and downward compatible. 
Compatibility provides for simplicity in 
education, availability of system 
backup, and ease in system growth. 
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Specifically, any program written for 
the 370-XA mode gives identical results 
on any system operating in that mode, 
provided that the program: 

1. Is not time-dependent. 

2. Does not depend on system facili- 
ties (such as storage capacity, I/O 
equipment, or optional facilities) 
being present when the facilities 
are not included in the configura- 
ti on. 

3. Does not depend on system facili- 
ties being absent when the facili- 
ties are included in the 
configuration. For example, the 
program must not depend on intei — 
ruptions caused by the use of 
operation codes or command codes 
that are not installed in some 
models. Also, it must not use or 
depend on fields associated with 
uninstalled facilities. For exam- 
ple, data should not be placed in 
an area used by another model for 
logout. Similarly, the program 
must not use or depend on unas- 
signed fields in machine formats 
(control registers, instruction 
formats, etc.) that are not explic- 
itly made available for program 
use. 

4. Does not depend on results or func- 
tions that are defined to be unpre- 
dictable or model-dependent. This 
includes the requirement that the 
program should not depend on the 
assignment of device numbers and 
CPU addresses. 

5. Does not depend on results or func- 
tions that are defined in the 
functi onal-character i st i cs publ i ca- 
tion for a particular model to be 
deviations from the architecture. 

6. Takes into account any changes made 
to the architecture that are iden- 
tified as affecting compatibility. 



COMPATIBILITY BETWEEN SYSTEMS IN 
SYSTEM/370 MODE AND IN 370-XA MODE 



To provide full control-program compat- 
ibility for the System/370 mode, all 
models which provide the 370-XA mode 
also offer manual controls that place 
the machine in the System/370 mode. 
When the system is in this mode, the 
operation of the system is as described 
i n the IBM System/370 Principles of 
Operation , 6A22-7000. 



Problem-State Compati bi 1 i tv 

A high degree of compatibility exists at 
the problem-state level in going forward 
from systems operating in the System/370 
mode to systems operating in the 370-XA 
mode. Because the majority of a user's 
applications are written for the problem 
state, this problem-state compatibility 
is useful in many installations. 

A problem-state program written for 
System/370 operates on a system in the 
370-XA mode, provided that the program: 

1. Complies with the limitations 
described in the section "Compat- 
ibility among Systems in 370-XA 
Mode." 

2. Is not dependent on control-program 
facilities which are unavailable on 
the system. 

3. Takes into account other changes 
made to the System/370 architec- 
tural definition that affect com- 
patibility between the System/370 
mode and the 370-XA mode. These 
changes are described in Appendix 
D. 



Control -Program Compati bi li tv 



Programmi ng Note 



This publication assigns meanings to 
various operation codes, to bit posi- 
tions in instructions, channel-command 
words, registers, and table entries, and 
to fixed locations in the low 512 bytes 
of storage. Unless specifically noted, 
the remaining operation codes, bit posi- 
tions, and low-storage locations are 
reserved for future assignment to new 
facilities and other extensions of the 
archi tecture. 



Control programs written for System/370 
cannot be directly transferred from 
those systems to systems operating in 
the 370-XA mode. This is because in the 
370-XA mode the basic-control mode is 
not present, new facilities for I/O are 
included, and the dynamic-address- 
translation facility is modified. (See 
Appendix D for a detailed comparison 
between the System/370 and 370-XA 
modes. ) 



To ensure that existing programs operate 
if and when such new facilities are 
installed, programs should not depend on 
an indication of an exception as a 
result of invalid values that are 
currently defined as being checked. If 
a value must be placed in unassigned 
positions that are not checked, the 
program should enter zeros. When the 
machine provides a code or field, the 
program should take into account that 



1-4 370-XA Principles of Operation 



new codes and bits may 
the future. The program 
unassigned low-storage 
keeping information 
locations may be assigned 
in such a way that the 



be assigned in 
should not use 
locations for 
since these 
in the future 
machine causes 



this location to be changed 



SYSTEM PROGRAM 



The system is designed to operate with a 
control program that coordinates the use 
of system resources and executes all I/O 
instructions* handles exceptional condi- 
tions, and supervises scheduling and 
execution of multiple programs. 



AVAILABILITY 



Availability is the capability of a 
system to accept and successfully proc- 
ess an individual job. Systems operat- 
ing in the 370-XA mode permit 
substantial availability by (1) allowing 
a large number and broad range of jobs 
to be processed concurrently, thus 
making the system readily accessible to 
any particular job, and (2) limiting the 
effect of an error and identifying more 
precisely its cause, with the result 
that the number of jobs affected by 
errors is minimized and the correction 
of the errors facilitated. 

Several design aspects make this possi- 
ble. 

• A program is checked for the 
correctness of instructions and 
data as the program is executed, 
and program errors are indicated 
separate from equipment errors. 
Such checking and reporting assists 
in locating failures and isolating 
effects. 

• The protection facilities, in 
conjunction with dynamic address 
translation, permit the protection 
of the contents of storage from 
destruction or misuse caused by 
erroneous cr unauthorized storing 
or fetching by a program. This 
provides increased security for the 
user, thus permitting applications 
with different security require- 
ments to be processed concurrently 
with other applications. 
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Multi processi ng and the channel 
subsystem permit better use of 
storage and processing capabili- 
ties, more direct communication 
between CPUs, and duplication of 
resources, thus aiding in the 
continuation of system operation in 
the event of machine failures. 

MONITOR CALL, program-event record- 
ing, and the timing facilities 
permit the testing and debugging of 
programs without manual intei — 
vention and with little effect on 
the concurrent processing of other 
programs. 

On most models, error checking and 
correction (ECC) in main storage, 
CPU retry, and command retry 
provide for circumventing intermit- 
tent equipment malfunctions, thus 
reducing the number of equipment 
fai lures. 
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A small number of manual controls 
&re required for basic system oper- 
ation, permitting most operator- 
system interaction to take place 
via a unit operating as an I/O 
device and thus reducing the possi- 
bility of operator errors. 
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Logical Structure of a 370-XA System 
with Two CPUs 
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A system viewed without regard to its 
I/O devices is referred to as a config- 
uration. All of the physical equipment, 
whether in the configuration or not, is 
referred to as the installation. 
Model-dependent reconfiguration controls 
may be provided to change the amount of 
main storage and the number of CPUs and 
channel paths in the configuration. In 
some instances, the reconfiguration 
controls may be used to partition a 
single configuration into multiple 
configurations. Each of the configura- 
tions so reconfigured has the same 
structure, that is, main storage, one or 
more CPUs, and one or more subchannels 
and channel paths in the channel subsys- 
tem. Each configuration is isolated in 
that the main storage in one configura- 
tion is not directly addressable by the 
CPUs and the channel subsystem of anoth- 
er configuration. It is, however, 
possible for one configuration to commu- 
nicate with another by means of shared 
I/O devices or a channel-to-channel 
adapter. At any one time, the storage, 
CPUs, subchannels, and channel paths 
connected together in a system are 
referred to as being in the configura- 
tion. Each CPU, subchannel, channel 
path, and main-storage location can be 
in only one configuration at a time. 



MAIN STORAGE 



Main storage, which is directly address- 
able, provides for high-speed processing 
of data by the CPUs and the channel 
subsystem. Both data and programs must 
be loaded into main storage from input 
devices before they can be processed. 
The amount of main storage available on 
the system depends on the model, and, 
depending on the model, the amount in 
the configuration may be under control 
of model-dependent configuration 
controls. The storage is available in 
multiples of 4K-byte blocks. At any 
instant in time, the channel subsystem 
and all CPUs in the configuration have 
access to the same blocks of storage and 
refer to a particular block of main- 
storage locations by using the same 
absolute address. 

I Main storage may include a faster-access 
buffer storage, sometimes called a 
cache. Each CPU may have an associated 
cache. The effects, except on perform- 
ance, of the physical construction and 
the use of distinct storage media are 
not observable by the program. 



CPU 



The central processing unit (CPU) is the 
controlling center of the system. It 



contains the sequencing and processing 

facilities for instruction execution, 

interruption action, timing functions, 

initial program loading, and other 
machine-related functions. 

The physical implementation of the CPU 
may differ among models, but the logical 
function remains the same. The result 
of executing an instruction is the same 
for each model, providing that the 
program complies with the compatibility 
rules. 

The CPU, in executing instructions, can 
process binary integers and floating- 
point numbers of fixed length, decimal 
integers of variable length, and logical 
information of either fixed or variable 
length. Processing may be in parallel 
or in series; the width of the process- 
ing elements, the multiplicity of the 
shifting paths, and the degree of simul- 
taneity in performing the different 
types of arithmetic differ from one CPU 
to another without affecting the logical 
results. 

Instructions which the CPU executes fall 
into five classes: general, decimal, 
floating-point, control, and I/O 
instructions. The general instructions 
are used in performing binary integer 
arithmetic operations and logical, 
branching, and other nonari thmeti c oper- 
ations. The decimal instructions 
operate on data in the decimal format, 
and the floating-point instructions on 
data in the floating-point format. The 
privileged control instructions and the 
I/O instructions can be executed only 
when the CPU is in the supervisor state; 
the semi pri vi leged control instructions 
can be executed in the problem state, 
subject to the appropriate authorization 
mechani sms. 

To perform its functions, the CPU may 
use a certain amount of internal 
storage. Although this internal storage 
may use the same physical storage medium 
as main storage, it is not considered 
part of main storage and is not address- 
able by programs. 

The CPU provides registers which are 
available to programs but do not have 
addressable representations in main 
storage. They include the current 
program-status word (PSW), the general 
registers, the floating-point registers, 
the control registers, the prefix regis- 
ter, and the registers for the clock 
comparator and the CPU timer. Each CPU 
in an installation provides access to a 
time-of-day (TOD) clock, which may be 
local to that CPU or shared with other 
CPUs in the installation. The instruc- 
tion operation code determines which 
type of register is to be used in an 
operation. See the figure "General, 
Floating-Point, and Control Registers" 
later in this chapter for the format of 
those registers. 
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PSW 



The program-status word (PSW) includes 
the instruction address, condition code, 
and other information used to control 
instruction sequencing and to determine 
the state of the CPU- The active or 
controlling PSW is called the current 
PSW. It governs the program currently 
being executed. 

The CPU has an interruption capability, 
which permits the CPU to switch rapidly 
to another program in response to excep- 
tional conditions and external stimuli. 
When an interruption occurs, the CPU 
places the current PSW in an assigned 
storage location, called the old-PSW 
location, for the particular class of 
interruption. The CPU fetches a new PSW 
from a second assigned storage location. 
This new PSW determines the next program 
to be executed. When it has finished 
processing the interruption, the i ntei — 
rupting program may reload the old PSW, 
making it again the current PSW, so that 
the interrupted program can continue. 

There are six classes of interruption: 
external, I/O, machine check, program, 
restart, and supervisor call. Each 
class has a distinct pair of old-PSW and 
new-PSW locations permanently assigned 
in real storage. 



(high-order) 32 bits. The next higher- 
numbered register contains the rightmost 
(low-order) 32 bits. 



GENERAL REGISTERS 



Instructions may designate information 
in one or more of 16 general registers. 
The general registers may be used as 
base-address registers and index regis- 
ters in address arithmetic and as accu- 
mulators in general arithmetic and 
logical operations. Each register 
contains 32 bits. The general registers 
sr& identified by the numbers 0-15 and 
are designated by a foui — bit R field in 
an instruction. Some instructions 
provide for addressing multiple general 
registers by having several R fields. 
For some instructions, the use of a 
specific general register is implied 
rather than explicitly designated by an 
R field of the instruction. 

For some operations, two adjacent gener- 
al registers are coupled, providing a 
64-bit format. In these operations, the 
program must designate an even-numbered 
register, which contains the leftmost 
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Four floating-point registers are avail- 
able for floating-point operations. 
They are identified by the numbers 0, 2, 
4, and 6 and are designated by a foui — 
bit R field in floating-point instruc- 
tions. Each floating-point register is 
64 bits long and can contain either a 
short (32-bit) or a long (64-bit) 
floating-point operand. A short operand 
occupies the leftmost bit positions of a 
floating-point register. The rightmost 
portion of the register is ignored in 
operations that use short operands and 
remains unchanged in operations that 
produce short results. Two pairs of 
adjacent floating-point registers can be 
used for extended operands: registers 
and 2, and registers 4 and 6. Each of 
these pairs, identified by the numbers 
and 4, provides for a 128-bit format. 



CONTROL REGISTERS 



The CPU has 16 control registers, each 
having 32 bit positions. The bit posi- 
tions in the registers are assigned to 
particular facilities in the system, 
such as program-event recording, and are 
used either to specify that an operation 
can take place or to furnish special 
information required by the facility. 

The control registers are identified by 
the numbers 0-15 and are designated by 
foui — bit R fields in the instructions 
LOAD CONTROL and STORE CONTROL. Multi- 
ple control registers can be addressed 
by these instructions. 
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R Register 
Field Number 



Control 
Regi sters 

—32 bits- 



General 
Regi sters 

|« 32 bits H 



Floating-Point Registers 



-64 bits- 



0000 



0001 



0010 



0011 



0100 



0101 



0110 



0111 



1000 



1001 



1010 10 



1011 11 



1100 12 



1101 13 



Note : The brackets 
indicate that the two 
registers may be coupled 
as a double-register 
pair, designated by 
specifying the lower- 
numbered register in 
the R field. For ex- 
ample/ the general- 
register pair 14 and 
15 is designated by 
1110 binary in the R 
field. 



1110 14 



1111 15 



General, Floating-Point, and Control Registers 
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VECTOR FACILITY 



Depending on the model, a vector facili- 
ty may be provided as an extension of 
the CPU. When the vector facility is 
provided on a CPU, it functions as an 
integral part of that CPU. The func- 
tions of the vector facility and its 
regijstej^s are described in the publica- 
tion IBM ^ Svstem/370 Vector Operations , 
SA22-7125. 



I/O 



Input/output (I/O) operations involve 
the transfer of information between main 
storage and an I/O device. I/O devices 
and their control units attach to the 
channel subsystem, which controls this 
data transfer. 



nels provided depends on the model and 
the configuration? the maximum number of 
subchannels is 65,536. 



I/O devices are attac 
units to the channel 
nel paths. Contro 
attached to the cha 
more than one channe 
device may be attache 
control unit. In all 
device may be accessi 
subsystem by as many 
channel paths, depen 
and the configuration 
of channel paths pro 
subsystem depends on 
configuration? the 
channel paths is 256. 



hed through control 
subsystem via chan- 
1 units may be 
nnel subsystem via 
1 path, and an I/O 
d to more than one 
, an individual I/O 
ble to the channel 

as eight different 

ding on the model 

The total number 

vided by a channel 

the model and the 
maximum number of 



I/O DEVICES AND CONTROL UNITS 



CHANNEL SUBSYSTEM 



The channel subsystem di rects the flow 
of information between I/O devices and 
main storage. It relieves CPUs of the 
task of communicating directly with I/O 
devices and permits data processing to 
proceed concurrently with I/O 
processing. The channel subsystem uses 
one or more channel paths as the commu- 
nication link in managing the flow of 
information to or from I/O devices. As 
part of I/O processing, the channel 
subsystem also performs the path- 
management function of testing for 
channel-path availability, selecting an 
available channel path, and initiating 
execution of the operation with the I/O 
device. Within the channel subsystem 
are subchannels. 



I/O devices include such equipment as 
card readers and punches, magnetic-tape 
units, direct-access storage, displays, 
keyboards, printers, teleprocessing 
devices, communications controllers, and 
sensoi — based equipment. Many I/O 
devices function with an external 
medium, such as punched cards or magnet- 
ic tape. Some I/O devices handle only 
electrical signals, such as those found 
in sensor-based networks. In either 
case, I/0-device operation is regulated 
by a control unit. In all cases, the 
control-unit function provides the 
logical and buffering capabilities 
necessary to operate the associated I/O 
device. From the programming point of 
view, most control-unit functions merge 
with I/0-device functions. The 
control-unit function may be housed with 
the I/O device or in the CPU, or a sepa- 
rate control unit may be used. 



One subchannel is provided for and dedi- 
cated to each I/O device accessible to 
the channel subsystem. Each subchannel 
contains storage for information 
concerning the associated I/O device and 
its attachment to the channel subsystem. 
The subchannel also provides storage for 
information concerning I/O operations 
and other functions involving the asso- 
ciated I/O device. Information 
contained in the subchannel can be 
accessed by CPUs using I/O instructions 
as well as by the channel subsystem and 
serves as the means of communication 
between any CPU and the channel subsys- 
tem concerning the associated I/O 
device. The actual number of subchan- 



OPERATOR FACILITIES 



The operator facilities provide the 
functions necessary for operator control 
of the machine. Associated with the 
operator facilities may be an operator- 
console device, which may also be used 
as an I/O device for communicating with 
the program. 

The main functions provided by the oper- 
ator facilities include resetting, 
clearing, initial program loading, 
start, stop, alter, and display. 
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This chapter discusses the represen- 
tation of information in main storage, 
as well as addressing, protection, and 
reference and change recording. The 
aspects of addressing which are covered 
include the format of addresses, the 
concept of address spaces, the various 
types of addresses, and the manner in 
which one type of address is translated 
to another type of address. A list of 
permanently assigned storage locations 
appears at the end of the chapter. 

Main storage provides the system with 
di rectly addressable fast-access storage 
of data. Both data and programs must be 
loaded into main storage (from input 
devices) before they can be processed. 

Main storage may include one or more 
smaller faster-access buffer storages, 
sometimes called caches. A cache is 
usually physically associated with a CPU 
or an I/O processor. The effects, 
except on performance, of the physical 
construction and use of distinct storage 
media are not observable by the program. 

Fetching and storing of data by a CPU 
are not affected by any concurrent 
channel-subsystem activity or by a 
concurrent reference to the same storage 
location by another CPU. When concui — 
rent requests to a main-storage location 
occur, access normally is granted in a 
sequence that assigns highest priority 
to references by the channel subsystem, 
the priority being rotated among CPUs. 
If a reference changes the contents of 
the location, any subsequent storage 
fetches obtain the new contents. 

Main storage may be volatile or nonvola- 
tile. If it is volatile, the contents 
of main storage are not preserved when 
power is turned off. If it is nonvola- 
tile, turning power off and then back on 
does not affect the contents of main 
storage, provided all CPUs are in the 
stopped state and no references are made 
to main storage when power is being 
turned off. In both types of main stoi — 
age, the contents of the storage key are 
not necessarily preserved when the power 
for main storage is turned off. 

Note : Because most references in this 
publication apply to virtual storage, 
the abbreviated term "storage" is often 
used in place of "virtual storage." The 
term "storage" may also be used in place 
of "main storage," "absolute storage," 
or "real storage" when the meaning is 
clear. The terms "main storage" and 
"absolute storage" are used to describe 
storage which is addressable by means of 
an absolute address. The terms describe 
fast-access storage, as opposed to 
auxiliary storage, such asi provided by 
direct-access storage devices. "Real 
storage" is synonymous with "absolute 
storage" except for the effects of 
pref ixi ng. 



STORAGE ADDRESSING 



Storage is viewed as a long horizontal 
string of bits. For most operations, 
accesses to storage proceed in a left- 
to-right sequence. The string of bits 
is subdivided into units of eight bits. 
An eight-bit unit is called a byte, 
which is the basic building block of all 
information formats. 



Each byte locat 
fied by a uni 
which is the 
location or, s 
Adjacent byte 1 
addresses, star 
and proceedin 
sequence. Addr 
or 31-bit unsi 
are described 
Size and Wrapar 



ion in storage is identi- 
que nonnegative integer, 
address of that byte 
imply, the byte address, 
ocations have consecutive 
ting with on the left 
g in a left-to-right 
esses are either 24-bit 
gned binary integers and 
in the section "Address 
ound" in this chapter. 



INFORMATION FORMATS 



Information is transmitted between stor- 
age and a CPU or the channel subsystem 
one byte, or a group of bytes, at a 
time. Unless otherwise specified, a 
group of bytes in storage is addressed 
by the leftmost byte of the group. The 
number of bytes in the group is either 
implied or explicitly specified by the 
operation to be performed. When used in 
a CPU operation, a group of bytes is 
called a field. 



Within each g 
numbered in a 
The leftmost b 
to as the "h 
rightmost bits 
Bit numbers a 
however. Only 
To operate on 
in storage, i 
the entire byt 



roup of bytes, bits are 
left-to-right sequence. 

its are sometimes referred 

igh-order" bits and the 
as the "low-order" bits. 

re not storage addresses, 
bytes can be addressed. 

individual bits of a byte 

t i s necessary to access 

e. 



The bits in a byte are numbered 
through 7, from left to right. 

The bits in an address are numbered 8 
through 31 for 24-bit addresses and 1 
through 31 for 31-bit addresses. Within 
any other fixed-length format of multi- 
ple bytes, the bits making up the format 
are consecutively numbered starting from 
0. 

For purposes of error detection, and in 
some models for correction, one or more 
check bits may be transmitted with each 
byte or with a group of bytes. Such 
check bits are generated automatically 
by the machine and cannot be directly 
controlled by the program. References 
in this publication to the length of 
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data fields and registers exclude 
mention of the associated check bits. 
All storage capacities are expressed in 
number of bytes. 

When the length of a storage-operand 
field is implied by the operation code 
of an instruction, the field is said to 
have a fixed length, which can be one, 
two, four, or eight bytes. Larger 
fields may be implied for some 
i nstructi ons. 

When the length of a storage-operand 
field is not implied but is stated 
explicitly, the field is said to have a 
variable length. Variable-length opei — 
ands can vary in length by increments of 
one byte. 

When information is placed in storage, 
the contents of only those byte 
locations are replaced that are included 
in the designated field,, even though the 
width of the physical path to storage 
may be greater than the length of the 
field being stored. 



boundary is called integral for a unit 
of information when its storage address 
is a multiple of the length of the unit 
in bytes. Special names are given to 
fields of two, four, and eight bytes on 
an integral boundary. A halfword is a 
group of two consecutive bytes on a 
two-byte boundary and is the basic 
building block of instructions. A word 
is a group of four consecutive bytes on 
a foui — byte boundary. A doubleword is a 
group of eight consecutive bytes on an 
eight-byte boundary. (See the figure 
"Integral Boundaries with Storage 
Addresses.") 

When storage addresses designate half- 
words, words, and doublewords, the bina- 
ry representation of the address 
contains one, two, or three rightmost 
zero bits, respectively. 

Instructions must be on two-byte inte- 
gral boundaries, and CCWs, IDAWs, and 
the storage operands of certain 
instructions must be on other integral 
boundaries. The storage operands of 
most instructions do not have boundary- 
alignment requirements. 



INTEGRAL BOUNDARIES 

Certain units of information must be on 
an integral boundary in storage. A 



Chapter 3. Storage 3-3 



-» Storage Addresses 



Bytes 



Halfwords 



Words 



Doublewords 



Integral Boundar 



es with Storage Addresses 



Programmi ng Note 



For fixed-field-length operations with 
field lengths that are a power of 2* 
significant performance degradation is 
possible when storage operands are not 
positioned at addresses that are inte- 
gral multiples of the operand length. 
To improve performance* frequently used 
storage operands should be aligned on 
integral boundaries. 



ADDRESS TYPES AND FORMATS 



ADDRESS TYPES 



For purposes of addressing main storage* 
three basic types of addresses are 
recognized: absolute* real* and 
virtual. The addresses are distin- 
guished on the basis of the transf- 
ormations that are applied to the 
address during a storage access. 
Address translation converts virtual to 
real* and prefixing converts real to 
absolute. In addition to the three 
basic address types* additional types 
are defined which are treated as one or 
another of the three basic types* 
depending on the instruction and the 
current mode. 



Absolute Address 



An absolute address is the address 
assigned to a main-storage location. An 



absolute address is used for a storage 
access without any transformations 
performed on it. 

The channel subsystem and all CPUs in 
the configuration refer to a shared 
main-storage location by using the same 
absolute address. Available main stor- 
age is usually assigned contiguous abso- 
lute addresses starting at 0, and the 
addresses are always assigned in 
complete 4K~byte blocks on integral 
boundaries. An exception is recognized 
when an attempt i s made to use an abso- 
lute address in a block which has not 
been assigned to physical locations. On 
some models* storage-reconfiguration 
controls may be provided which permit 
the operator to change the correspond- 
ence between absolute addresses and 
physical locations. However* at any one 
time* a physical location is not associ- 
ated with more than one absolute 
address. 

Storage consisting of byte locations 
sequenced according to their absolute 
addresses is referred to as absolute 
storage. 



Real Address 



A real address identifies a location in 
real storage. When a real address is 
used for an access to main storage* it 
is converted* by means of prefixing* to 
an absolute address. 

At any instant there is one real-address 
to absolute-address mapping for each CPU 
in the configuration. When a real 
address is used by a CPU to access main 
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storage, it is converted to an absolute 
address by prefixing. The particular 
transformation is defined by the value 
in the prefix register for the CPU. 

Storage consisting of byte locations 
sequenced according to their real 
addresses is referred to as real 
storage. 



Vi rtual Address 



A virtual address identifies a location 
in virtual storage. Nhen a virtual 
address is used for an access to main 
storage, it is translated by means of 
dynamic address translation to a real 
address, which is then further converted 
by prefixing to an absolute address. 
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contains a 
address. 



the instruction definition 
definition of the type of 



Primary Vi rtual Address 
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Secondary Vi rtual Address 
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A secondary virtual address is a v 
address which is to be translat 
means of the secondary segment 
designation. Logical addresses 
treated as secondary virtual add 
when in the secondary-space mode 
second-operand address of MOVE TO 
RY and the first-operand address o 
TO SECONDARY are always treat 
secondary virtual addresses. 



Logi cal Address 



Except where otherwise specified, the 
storage-operand addresses for most 
instructions are logical addresses. 
Logical addresses are treated as real 
addresses in the real mode, treated as 
primary virtual addresses in the 
primary-space mode, and treated as 
secondary virtual addresses in the 
secondary-space mode. Some instructions 
have storage-operand addresses or stor- 
age accesses associated with the 
instruction which do not follow the 
rules for logical addresses. In all 



Instruction Address 



Addresses used to fetch instructions 
from storage are called instruction 
addresses. Instruction addresses are 
treated as real addresses in the real 
mode, treated as primary virtual 
addresses in the primary-space mode, and 
treated as either primary virtual 
addresses or secondary virtual addresses 
in the secondary-space mode. The 
instruction address in the current PSUI 
and the target address of EXECUTE are 
instruction addresses. 



Note : When the CPU 
secondary-space mode, i 
able whether instruction 
target of EXECUTE, are 
primary address space o 
address space. For de 
section "Translation M 
associated programming 
section "Dynamic Address 
this chapter. 



Effecti ve Address 



is in the 
t i s unpredict- 
s, including the 
fetched from the 
r the secondary 
tails, see the 
odes" and the 
notes under the 
Translation" in 



In some situations, it is convenient to 
use the term "effective address." An 
effective address is the address which 
results from address arithmetic, before 
address translation, if any, is 
performed. Address arithmetic is the 
addition of the base and displacement or 
of the base, index, and displacement. 



ADDRESS SIZE AND WRAPAROUND 



Two sizes of addresses are provided: 
24-bit and 31-bit. A 24-bit address can 
accommodate a maximum of 16,777,216 
(16M) bytes; with a 31-bit address, 
2,147,483,648 (2G) bytes of storage can 
be addressed. 

The bits of the address are numbered 
8-31 and 1-31, respectively, correspond- 
ing to the numbering of base-address and 
index bits in a general register: 





24-bit Address 


8 


31 




31-Bit Address 



31 
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The size of the real addresses yielded 
by the ASN-translati on, PC-number-trans- 
lation ASN-authori zati on, and tracing 
processes, and the real (or absolute) 
addresses yielded by the DAT process, is 
always 31 bits. 

The size of the data address in a CCW is 
under control of the format-control bit 
in the operation-request block desig- 
nated by a START SUBCHANNEL instruction. 
The CCWs with 24-bit and 31-bit 
addresses are called format-0 and 
format-1 CCWs, respectively. Format-0 
and format-1 CCWs are described in Chap- 
ter 15, "Basic I/O Functions." 



Address Wraparound 



The CPU performs address generation when 
it forms an operand or instruction 
address or when it generates the address 
of a table entry from the appropriate 
table origin and index. It also 
performs address generation when it 
increments an address to access succes- 
sive bytes of a field. Similarly, the 
channel subsystem performs address 
generation when it increments an address 
(1) to fetch a CCW, (2) to fetch an 
IDAW, or (3) to transfer data. 

When, during the generation of the 
address, an address is obtained that 
exceeds the value allowed for the 
address size (2 24 - 1 or 2 31 - 1), one 
of the following two actions is taken: 

1. The carry out of the high-order bit 
position of the address is ignored. 
This handling of an address of 
excessive size is called 
wraparound . 



An interruption condition is 
ni zed. 



recog- 



The effect of wraparound i s to make an 
address space appear circular; that is, 
address appears to follow the maximum 
allowable address. Address arithmetic 
and wraparound occur before transforma- 
tion, if any, of the address by DAT or 
pref i xi ng. 

Addresses generated by the CPU always 
wrap, except for addresses generated for 
DAT-table entries. For DAT-table 
entries, it is unpredictable whether the 
address wraps or whether an addressing 
exception is recognized. 

For channel-program execution, when the 
generated address exceeds the value for 
the address size (or, for the read- 
backward command i s decremented below 
0), an I/O program-check condition is 
recogni zed. 

The figure "Address-Space Wraparound" 
identifies what limit values apply to 
the generation of different addresses 
and how addresses are handled when they 
exceed the allowed value. 
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Address Generation for 


Address 
Type 


Handling When 
Address Would 
Wrap 


Instructions and operands when AM is 
zero 


L,I,R,V 


W24 




Successive bytes of instructions and 
operands when AM i s zero 


I.UV 1 


W24 




Instructions and operands when AM is 
one 


UI,R,V 


W31 




Successive bytes of instructions and 
operands when AM i s one 


IrUV 1 


W31 




DAT-table entries when used for 
implicit translation 


A or R 2 


X31 




DAT-table entries when used for LRA 


A or R 2 


X31 




ASN-f i rst-table, ASN-second-table, 
author i zati on-table, li nkage-table, 
and entry-table entries 


R 


W31 




I/O measurement block 


A 


P31 




For a channel program with format-0 
CCWs: 








Channel-program address in ORB 


A 


P24 




Successive CCWs 


A 


P24 




Successive IDAWs 


A 


P24 




Successive bytes of I/O data 
(without IDAWs) 


A 


P24 




Successive bytes of I/O data 
(with IDAWs) 


A 


P31 




For a channel program with format-1 
CCWs: 








Channel-program address in ORB 


A 


P31 




Successive CCWs 


A 


P31 




Successive IDAWs 


A 


P31 




Successive bytes of I/O data 
(without IDAWs) 


A 


P31 




Successive bytes of I/O data 
(with IDAWs) 


A 


P31 





Address Wraparound (Part 1 of 2) 
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Explanati on ? 



1 Real addresses do not apply in this case since the in- 
structions which designate operands by means of real ad- 
dresses cannot designate operands that cross boundaries 
2 24 and 2 31 . 

2 It is unpredictable whether the address is absolute or 
real . 

A Absolute address. 

AM Addressing mode bit in the PSW. 

I Instruction address. 

L Logical address. 

P24 An I/O program-check condition is recognized when the 

address exceeds 2 24 - 1 or i s decremented below zero. 
P31 An I/O program-check condition is recognized when the 

address exceeds 2 31 - 1 or is decremented below zero. 
R Real address. 
V Virtual address. 

W24 Wrap to location after location 2 24 - 1 and vice versa, 
W31 Wrap to location after location 2 31 - 1 and vice versa. 
X31 When the address exceeds 2 31 - 1, it is model-dependent 

whether the address wraps to location after location 

2 31 - 1 or whether an addressing exception is recognized, 



Address Wraparound (Part 2 of 2) 



STORAGE KEY 



A storage key is associated with each 
4K-byte block of storage that is avail- 
able in the configuration. The storage 
key has the following format: 



ACC 


F 


R 


C 



The bit positions in the storage key are 
allocated as follows: 

Access-Control Bits (ACC): If a refer- 
ence is subject to key-controlled 
protection, the four access-control 
bits, bits 0-3, are matched with the 
foui — bit access key when information is 
stored, or when information is fetched 
from a location that is protected 
against fetching. 

Fetch-Protecti on Bi t ( F) : If a refer- 
ence is subject to key-controlled 
protection, the fetch-protection bit, 
bit 4, controls whether key-controlled 
protection applies to fetch-type refer- 
ences: a zero indicates that only 
store-type references are monitored and 
that fetching with any access key is 
permitted; a one indicates that key- 
controlled protection applies to both 
fetching and storing. No distinction is 
made between the fetching of 
instructions and of operands. 

Reference Bi t (R) : The reference bit, 
bit 5, normally is set to one each time 
a location in the corresponding storage 
block is referred to either for storing 
or for fetching of information. 



Change Bi t (C) : The change bit, bit 6, 
is set to one each time information is 
stored at a location in the correspond- 
ing storage block. 
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Key-controlled protection affords 
protection against improper storing or 
against both improper storing and fetch- 
ing, but not against improper fetching 
alone. 
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KEY-CONTROLLED PROTECTION 



When key-controlled protection applies 
to a storage access, a store is permit- 
ted only when the storage key matches 
the access key associated with the 
request for storage access; a fetch is 
permitted when the keys match or when 
the fetch-protection bit of the storage 
key i s zero. 



The keys are said to match when the four 
access-control bits of the storage key 
are equal to the access key, or when the 
access key is zero. 



The protection action 
the figure "Summary 
Acti on." 



is summarized in 
of Protection 



Condi ti ons 



Fetch-Protecti on 
Bit of 
Storage Key 



Key Relation 



Is Access to 
Storage Permitted? 



Fetch 



Store 



Match 
Mi smatch 
Match 
Mi smatch 



Yes 


Yes 


Yes 


No 


Yes 


Yes 


No 


No 



Explanati on ? 



Match The four access-control bits of the storage 

key are equal to the access key, or the access 
key i s zero . 

Yes Access is permitted. 

No Access is not permitted. On fetching, the 
information is not made available to the 
program; on storing, the contents of the 
storage location are not changed. 



Summary of Protection Action 
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When the access to storage is initiated 
by the CPU and key-controlled protection 
appliest the PSW key is the access key, 
except that, for the second operand of 
MOVE WITH KEY and MOVE TO PRIMARY and 
the first operand of MOVE TO SECONDARY, 
the access key is specified in a general 
register. The PSW key occupies bit 
positions 8-11 of the current PSW." 



When the access to s 
purpose of channel-p 
the subchannel key as 
channel program i s the 
subchannel key for a 
specified in the opera 
(ORB). When, for pur 
subsystem monitoring, 
measurement block 
measurement-block key 
The measurement-block 
by the SET CHANNEL MON 



torage is for the 

rogram execution, 

sociated with that 

access key. The 

channel program i s 

tion-request block 

poses of channel- 

an access to the 

i s made, the 

is the access key. 

key i s speci f i ed 

ITOR instruction. 



When a CPU access i s proh 
of key-controlled protect 
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instruction is terminated, 
interruption for a protec 
takes place. When a c 
access is prohibited, the 
is ended, and the pr 
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interruption-response bloc 
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prohibited, the I/O mea 
protection-check condition 
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When a store access is prohibited 
because of key-controlled protection, 
the contents of the protected location 
remain unchanged. When a fetch access 
is prohibited, the protected information 
is not loaded into a register, moved to 
another storage location, or provided to 
an I/O device. For a prohibited 
instruction fetch, the instruction is 
suppressed, and an arbitrary 
instruction-length code is indicated. 

Key-controlled protection is independent 
of whether the CPU is in the problem or 
the supervisor state and, except as 
described below, does not depend on the 
type of CPU instruction or channel- 
command word being executed. 

Except where otherwise specified, all 
accesses to storage locations that are 
explicitly designated by the program and 
that are used by the CPU to store or 
fetch information are subject to key- 
controlled protection. 

Accesses to the second operand of TEST 
BLOCK are not subject to key-controlled 
protecti on. 

All storage accesses by the channel 
subsystem to access the I/O measurement 
block, or by a channel program to fetch 
a CCW or IDAW or to access a data area 
designated during the execution of a 
CCW, are subject to key-controlled 
protection. However, if a CCW, an IDAW, 



or output data is prefetched, a 
protection check is not indicated until 
the CCW or IDAW is due to take control 
or until the data is due to be written. 

Key-controlled protection is not applied 
to accesses that are implicitly made for 
any of such sequences as: 

• An interruption 

• CPU logout 

• Fetching of table entries for 
dynamic-address translation, PC- 
number translation, ASN transla- 
tion, or ASN authorization 

• Tracing 

• A store-status function 

• Storing in real locations 184-191 
when TEST PENDING INTERRUPTION has 
an operand address of zero 

• Initial program loading 

Similarly, protection does not apply to 
accesses initiated via the operator 
facilities for altering or displaying 
information. However, when the program 
explicitly designates these locations, 
they are subject to protection. 



Fetch-Protecti on-Override Control 



Bit 6 of control register is the 
fetch-protection-override control. When 
the bit is one, fetch protection is 
ignored for locations at effective 

0-2047. Fetch-protection 
applies to instruction fetch 

the fetch accesses of 



addresses 
overri de 

and to intj i tfiLii aumaatia ui 

instructions whose operand addresses are 
logical, virtual, or real. It does not 
apply to fetch accesses made for the 
purpose of channel-program execution or 
for the purpose of channel-subsystem 
monitoring. When this bit is set to 
zero, fetch protection of locations at 
effective addresses 0-2047 is determined 
by the state of the fetch-protection bit 
of the storage key associated with those 
locati ons. 

Fetch-protection override has no effect 
on accesses which are not subject to 
key-controlled protection. 



PAGE PROTECTION 



The page-protection facility controls 
access to virtual storage by using the 
page-protection bit in each page-table 
entry. It provides protection against 
improper storing. 
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The page-protection bit, bit 22 of the 
page-table entry, controls whether stor- 
ing is allowed into the corresponding 
4K-byte page. When the bit is zero, 
both fetching and storing are permitted; 
when the bit is one, only fetching is 
permitted. When an attempt is made to 
store into a protected page, a program 
interruption for protection takes place. 
The contents of the protected location 
remain unchanged. 

Page protection applies to all store- 
type references that use a virtual 
address. 



Programming Note 



Low-address protection and key- 
controlled protection apply to the same 
store accesses, except that: 

• Low-address protection does not 
apply to storing performed by the 
channel subsystem, whereas key- 
controlled protection does. 

• Key-controlled protection does not 
apply to tracing or the second 
operand of TEST BLOCK, whereas 
low-address protection does. 



LOW-ADDRESS PROTECTION 



REFERENCE RECORDING 



The low-address-protection facility 
provides protection against the 
destruction of main-storage information 
used by the CPU during interruption 
processing. This is accomplished by 
prohibiting instructions from storing 
with effective addresses in the range 
through 511. The range criterion is 
applied before address transformation, 
if any, of the address by dynamic 
address translation or prefixing. 

Low-address protection is under control 
of bit 3 of control register 0, the 
low-address-protecti on-control bit. 
When the bit is zero, lew-address 
protection is off; when the bit is one, 
low-address protection is on. 

If an access is prohibited because of 
low-address protection, the contents of 
the protected location remain unchanged, 
a program interruption for a protection 
exception takes place, and the unit of 
operation is suppressed or the instruc- 
tion terminated. 

Any attempt by the program to store by 
using effective addresses in the range 
through 511 are subject to low-address 
protection. Low-address protection is 
applied to the store accesses of 
instructions whose operand addresses are 
logical, virtual, or real. Low-address 
protection is also applied to the trace 
table. 

Low-address protection is not applied to 
accesses made by the CPU or the channel 
subsystem for such sequences as intei — 
ruptions, the storing of the 1/0- 
interruption code in real locations 
184-191 by TEST PENDING INTERRUPTION, 
and the initial-program-loading and 
store-status functions, nor is it 
applied to data stores during I/O data 
transfer. However, explicit stores by a 
program at any of these locations are 
subject to low-address protection. 



Reference recording provides information 
for use in selecting pages for replace- 
ment. Reference recording uses the 
reference bit, bit 5 of the storage key. 
The reference bit is set to one each 
time a location in the corresponding 
storage block is referred to either for 
fetching or storing information, regard- 
less of whether DAT is on or off. 

Reference recording is always active and 
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INSERT STORAGE KEY EXTENDED 

INSERT VIRTUAL STORAGE KEY 
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bit is set to a specified 
value) 
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CHANGE RECORDING 



Change recording provides information as 
to which pages have to be saved in 
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auxiliary storage when they are replaced 
in main storage. Change recording uses 
the change bit, bit 6 of the storage 
key. 

The change bit is set to one each time a 
store access causes the contents in the 
corresponding storage block to be 
changed. A store access that does not 
change the contents of storage may or 
may not set the change bit to one. 

The change bit is not set to one for an 
attempt to store if the access is 
prohibited. In particular: 

1. For the CPU, a store access is 
prohibited whenever an access 
exception exists for that access, 
or whenever an exception exists 
which is of higher priority than 
the priority of an access exception 
for that access. 

2. For the channel subsystem, a store 
access is prohibited whenever a 
key-controlled-protecti on violation 
exists for that access. 

Change recording is always active and 
takes place for all store accesses to 
storage, including those made by any 
CPU, any operator facility, or the chan- 
nel subsystem. It takes place for 
implicit references made by the machine, 
such as those which are part of inter- 
rupti ons. 

Change recording does not take place for 
the operands of the following 
instructions since they directly modify 
a storage key without modifying a stor- 
age location: 

RESET REFERENCE BIT EXTENDED 

SET STORAGE KEY EXTENDED (change 

bit is set to a specified 

value) 

Change bits which have been changed from 
zeros to ones are not necessarily 
restored to zeros on CPU retry (see the 
section "CPU Retry" in Chapter 11, 
"Machine-Check Handling"). See the 
section "Exceptions to Nullification and 
Suppression" in Chapter 5, "Program 
Execution," for a description of the 
handling of the change bit in certain 
unusual situations. 



PREFIXING 



Prefixing provides the ability to assign 
the range of real addresses 0-4095 (the 
prefix area) to a different block in 
absolute storage for each CPU, thus 



permitting more than one CPU sharing 
main storage to operate concurrently 
with a minimum of interference, espe- 
cially in the processing of 
i nterrupt i ons. 

Prefixing causes real addresses in the 
range 0-4095 to correspond to the block 
of 4K absolute addresses identified by 
the value in the prefix register for the 
CPU, and the block of real addresses 
identified by the value in the prefix 
register to correspond to absolute 
addresses 0-4095. The remaining real 
addresses are the same as the corre- 
sponding absolute addresses. This 
transformation allows each CPU to access 
all of main storage, including the first 
4K bytes and the locations designated by 
the prefix registers of other CPUs. 

The relationship between real and abso- 
lute addresses is graphically depicted 
in the figure "Relationship between Real 
and Absolute Addresses." 



The prefix is 
contained in bit 
prefix register, 
following format: 



a 19-bit quantity 

positions 1-19 of the 

The register has the 



/ 


Prefix 


//////////// 



20 



31 



The contents of the regi ster can be set 
and inspected by the privileged 
instructions SET PREFIX and STORE 
PREFIX, respectively. On setting, bits 
corresponding to bit positions and 
20-31 of the prefix register are 
ignored. On storing, zeros are provided 
for these bit positions. When the 
contents of the prefix register sre 
changed, the change is effective for the 
next sequential instruction. 

When prefixing is applied, the real 
address is transformed into an absolute 
address by using one of the following 
rules, depending on bits 1-19 of the 
real address: 

1. Bits 1-19 of the address, if all 
zeros, are replaced with bits 1-19 
of the prefix. 

2. Bits 1-19 of the address, if equal 
to bits 1-19 of the prefix, are 
replaced with zeros. 

3. Bits 1-19 of the address, if not 
all zeros and not equal to bits 
1-19 of the prefix, remain 
unchanged. 



In all cases, bits 
remain unchanged. 



20-31 of the address 
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4096 
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Real Addresses 
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(1) Real addresses in which bits 1-19 are equal to the prefix for this CPU (A or 
B). 

(2) Absolute addresses of the block that contains for this CPU (A or B) the real 
locations 0-4095. 

Relationship between Real and Absolute Addresses 



Only the address presented to storage is 
translated by prefixing. The contents 
of the source of the address remain 
unchanged. 

The distinction between real and abso- 
lute addresses is made even when the 
prefix register contains all zeros, in 
which case a real address and its corre- 
sponding absolute address are identical. 



ADDRESS SPACES 



An address space is a consecutive 
sequence of integer numbers (virtual 
addresses) , together with the specific 
transformation parameters which allow 
each number to be associated with a byte 
location in storage. The sequence 
starts at zero and proceeds left to 
ri ght . 

When a virtual address is used by a CPU 
to access main storage, it is first 



converted, by means of dynamic address 
translation (DAT), to a real address, 
and then, by means of prefixing, to an 
absolute address. DAT uses two levels 
of tables (segment tables and page 
tables) as transformation parameters. 
The designation (origin and length) of a 
segment table is found for use by DAT in 
a control register. 



At any instant 
virtual addres 
spaces — the p 
consisting of pr 
and the seco 
consisting of 
addresses. The 
the primary add 
by control regis 
the secondary a 
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ress space is specified 
ter 1 and that defining 
ddress space by control 



Each address space is assigned an 
address-space number (ASN). An ASN- 
translation mechanism is provided which, 
given an ASN, can locate (by using a 
two-level table lookup) the designation 
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of the segment table which defines the 
address space. Certain instructions use 
ASN translation and load the resulting 
segment-table designation into the 
appropriate control register. 

By using the ASN-translati on mechanism, 
any one of up to 64K address spaces can 
be selected to become the primary or 
secondary address space. 

The ASNs for the primary and secondary 
address spaces are assigned positions in 
control registers. The ASN for the 
primary address space, called the prima- 
ry ASN, is assigned bits 16-31 of 
control register 4, and that for the 
secondary address space, called the 
secondary ASN, is assigned bits 16-31 of 
control register 3. The registers have 
the following formats: 

Control Regi ster 4 



SPACE PARAMETERS. The ASN-translati on 
process is the same for both primary and 
secondary ASN translation; only the uses 
of the results of the process are 
di f f erent . 

The ASN-translati on process uses two 
tables, the ASN first table and the ASN 
second table. They are used to locate 
the address-space-control parameters and 
a third table, the authority table, 
which is used when ASN authorization is 
performed. 

For the purposes of this translation, 
the 16-bit ASN is considered to consist 
of two parts: the ASN-f i rst-table index 
(AFX) is the leftmost 10 bits of the 
ASN, and the ASN-second-table index 
(ASX) is the six rightmost bits. The 
ASN has the following format: 

ASN 



PASN 



16 



31 



AFX 


ASX 



10 



15 



Control Register 3 



SASN 



16 



31 



An instruction that uses ASN translation 
and loads the primary or secondary 
segment-table designation into the 
appropriate control register also loads 
the corresponding ASN into the appropri- 
ate control register. 

Note : Virtual storage consisting of 
byte locations ordered according to 
their virtual addresses in an address 
space is usually referred to as 
"storage." 



The AFX is used to 
the ASN first table. 
ASN first table is 
ASN-f i rst-table orig 
ter 14. The ASN 
contains the origin 
table. The ASX is 
entry from the ASN 
entry contains the a 
parameters. 
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ASN-TRANSLATION CONTROLS 



ASN translation is controlled by 
ASN-translati on-control bit and 
ASN-f i rst-table origin, both of 
reside in control register 14 
register has the following format 



the 
the 
whi ch 
The 



ASN TRANSLATION 



ASN translation is the process of trans- 
lating the 16-bit ASN to locate the 
address-space-control parameters. ASN 
translation is performed as part of 
PROGRAM CALL with space switching 
(PC-ss), PROGRAM TRANSFER with space 
switching (PT-ss), and SET SECONDARY ASN 
with space switching (SSAR-ss). ASN 
translation is also performed as part of 
LOAD ADDRESS SPACE PARAMETERS. For 
PC-ss and PT-ss, the ASN which is trans- 
lated replaces the primary ASN in 
control register 4. For SSAR-ss, the 
ASN which is translated replaces the 
secondary ASN in control register 3. 
These two translation processes &r& 
called primary ASN translation and 
secondary ASN translation, respectively, 
and both can occur for LOAD ADDRESS 



Control Register 14 



AFTO 



12 



31 



ASN-Translation Control (J_) : Bit 12 of 
control register 14 is the ASN- 
translati on-control bit. This bit 
provides a mechanism whereby the control 
program can indicate whether ASN trans- 
lation can occur while a particular 
program is being executed. Bit 12 must 
be one to allow completion of these 
i nstructi ons: 

LOAD ADDRESS SPACE PARAMETERS 
SET SECONDARY ASN 

PROGRAM CALL with space switching 
PROGRAM TRANSFER with space switch- 
i ng 
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Otherwise, a special-operation exception 
is recognized. The ASN-translati on- 
control bit is examined in both the 
problem and the supervisor states. 

ASN-First-Table Origin ( AFTO ): Bits 
13-31 of control register 14, with 12 
zeros appended on the right, form a 
31-bit real address that designates the 
beginning of the ASN first table. 



ASN-TRANSLATION TABLES 



The ASN-translati on process consists in 
a two-level lookup using two tables: an 
ASN first table and an ASN second table. 
These tables reside in real storage. 
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ASN-Fi rst-Table Entri es 



The fields in the entry are allocated as 
follows: 



The entry fetched from the ASN first 
table has the following format: 



ASTO 



0000 



1 28 31 

The fields in the entry are allocated as 
follows: 

AFX-Invalid Bit (I): Bit controls 
whether the ASN second table associated 
with the ASN-f i rst-table entry is avail- 
able. When bit is zero, ASN trans- 
lation proceeds by using the designated 
ASN second table. When the bit is one, 
the ASN translation cannot continue. 

ASN-Second-Table Origin ( ASTO ) : Bits 
1-27, with four zeros appended on the 
right, are used to form a 31-bit real 
address that designates the beginning of 
the ASN second table. 



Bits 28-31 of the 
zeros; otherwise, 



AFT entry must be 
an ASN-translati on- 



specification exception is recognized as 
part of the execution of the instruction 
that entry for ASN translation. 



pa 
usi ng 



ASN-Second-Table Entri es 



The entry fetched from the ASN second 
table has the following format: 



ASX-Invalid 
whether the 
with the 
avai lable. 
translat i on 
one, the 
conti nue. 



Bit CI): Bit 
address space 
ASN- second- table 
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controls 
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the bit is 



ASN 



translati on 



cannot 



Authority-Table Origin ( ATO ) : Bits 
1-29, with two zeros appended on the 
right, are used to form a 31-bit real 
address that designates the beginning of 
the authority table. 

Authorization Index ( AX) : Bits 32-47 
are used as a result of primary ASN 
translation by PROGRAM CALL and PROGRAM 
TRANSFER and may be used by LOAD ADDRESS 
SPACE PARAMETERS. The AX field is 
ignored for secondary ASN translation. 
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Segment-Table Desi gnat i on ( STD ) : Bits 
64-95 are used as a result of ASN trans- 
lation to replace the primary-segment- 
table designation (PSTD) or the 
secondary-segment-table desi gnat i on 
(SSTD). For SET SECONDARY ASN, the STD 
field is placed in the SSTD, bits 0-31 
of control register 7. For PROGRAM 
CALL, the STD field is placed in the 
PSTD, bits 0-31 of control register 1. 
Each of these actions may occur inde- 
pendently for LOAD ADDRESS SPACE 
PARAMETERS. For PROGRAM TRANSFER, the 
STD field is placed in both the PSTD and 
SSTD, bits 0-31 of control registers 1 
and 7, respectively. The contents of 
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the entire STD field are placed In the 
appropriate control registers without 
being inspected for validity. 

Soace-Swi tch-Event Control (X): Bit 
of the segment-table designation is the 
space-switch-event-control bit. When, 
in PC-ss or PT-ss, this bit is one in 
control register 1 either before or 
after the execution of the PC-ss or 
PT-ss, a program interruption for a 
space-switch event occurs after the 
execution of the instruction is 
completed. When, in LOAD ADDRESS SPACE 
PARAMETERS, this bit is one during 
primary ASN translation, this fact is 
indicated by the condition code. 

L i nkage-Table Desi gnati on ( LTD ) ' Bits 
96-127 are used as a result of primary 
ASN translation. The linkage-table- 
designation field contains the 
subsystem-linkage-control bit (V) (bit 
96), the linkage-table origin (LTO) 
(bits 97-120), and the linkage-table 
length (LTD (bits 121-127). The 
contents of the LTD field are placed in 
control register 5 as a result of prima- 
ry ASN translation. 

Bits 30, 31, and 60-63 of the AST entry 
must be zeros; otherwise, an ASN- 
translation-specification exception is 
recognized as part of the execution of 
the instruction using that entry for ASN 
translati on. 



ASN-TRANSLATION PROCESS 



This section describes the ASN- 
translation process as it is performed 
during the execution of PROGRAM CALL 
with space switching, PROGRAM TRANSFER 
with space switching, and SET SECONDARY 
ASN with space switching. ASN trans- 
lation for LOAD ADDRESS SPACE PARAMETERS 
is the same, except that AFX-translat i on 
and ASX-translati on exceptions do not 
occur; such situations are instead indi- 
cated by the condition code. 
Translation of an ASN is performed by 
means of two tables, an ASN first table 
and an ASN second table, both of which 
reside in main storage. 

The ASN first index is used to select an 
entry from the ASN first table. This 
entry designates the ASN second table to 
be used. 

The ASN second index is used to select 
an entry from the ASN second table. 
This entry contains the address-space- 
control parameters. 

If the I bit is one in either the ASN- 
first-table entry or ASN-second-table 
entry, the entry is invalid, and the 
ASN-translati on process cannot be 
completed. An AFX-translat i on exception 
or ASX-translati on exception is recog- 
ni zed. 



Programmi no Note 



The unused portion of the STD field, 
bits 84-88 of the AST entry, which 
corresponds to bits 20-24 of the PSTD 
and SSTD, should be set to zeros. These 
bits are reserved for future expansion, 
and programs which place nonzero values 
in these bit positions may not operate 
compatibly on future machines. 



Whenever access to main storage is made 
during the ASN translation process for 
the purpose of fetching an entry from an 
ASN first table or ASN second table, 
key-controlled protection does not 
apply. 

The ASN translation process is shown in 
the figure "ASN Translation." 
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R: Address is real 



ASN Translation 



ASN-Fi rst-Table Lookup 



The AFX portion of the ASN, in conjunc- 
tion with the ASN-f i rst-table origin, is 
used to select an entry from the ASN 
second table. 
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All four bytes of the ASN-f i rst-table 
entry appear to be fetched concurrently 
as observed by other CPUs. The fetch 
access is not subject to protection. 
When the storage address which is gener- 
ated for fetching the ASN-f i rst-table 
entry designates a location which is not 



available in the configuration, an 
addressing exception is recognized, and 
the operation is suppressed. 



Bit of the four-byte 
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translation exception i 
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When no exceptions ar& 
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ASN-Second-Table Lookup 



The ASX portion of the ASN, in conjunc- 
tion with the ASN-second-table origin 
contained in the ASN-f i rst-table entry, 
is used to select an entry from the ASN 
second table. 

The 31-bit real address of the ASN- 
second-table entry is obtained by 



Chapter 3. Storage 3-17 



appending four zeros on the right to 
bits 1-27 of the ASN-f i rst-table entry 
and adding the ASX with four rightmost 
and 21 leftmost zeros appended. A 
carry* if any, into bit position is 
ignored. All 31 bits of the address are 
used, regardless of whether the current 
PSW specifies the 24-bit or 31-bit 
addressing mode. 

The 16 bytes of the ASN-second-table 
entry appear to be fetched word- 
concurrent as observed by other CPUs, 
with the leftmost word fetched first. 
The order in which the remaining three 
words are fetched is unpredictable. The 
fetch access is not subject to 
protection. When the storage address 
which is generated for fetching the 
ASN-second-table entry designates a 
location which is not available in the 
configuration, an addressing exception 
is recognized, and the operation is 
suppressed. 

Bit of the 16-byte ASN-second-table 
entry specifies whether thvg address 
space is accessible. If this bit is 
one, an ASX-translati on exception is 
recognized. If bit positions 30, 31, 
and 60-63 of the ASN-second-table entry 
do not contain zeros, an ASN- 
translation-specification exception is 
recogni zed. 



Recogni ti on of Excepti ons duri r>q ASN 
Translate on 



zation tests whether the ASN can be 
established as the secondary ASN and is 
called secondary-ASN authorization. 

The ASN authorization is performed by 
means of an authority table in real 
storage which is designated by the 
authority-table-origin and authority- 
table-length fields in the ASN-second- 
table entry. 



ASN-AUTHORIZATION CONTROLS 



ASN authorization uses the authority- 
table origin and the authority-table 
length from the ASN-second-table entry, 
together with an authorization index. 



Control Regi ster 4 



For PT-ss and SSAR-ss, the current 
contents of control register 4 include 
the authorization index. For LOAD 
ADDRESS SPACE PARAMETERS, the value 
which will become the new contents of 
control register 4 is used. The regis- 
ter has the following format? 



AX 



15 



The exceptions which can be encountered 
during the ASN-translati on process are 
collectively referred to as ASN- 
translation exceptions. A list of these 
exceptions and their priorities is given 
in Chapter 6, "Interruptions." 



Authorization Index (AX): Bits 0-15 of 
control register 4 are used as an index 
to locate the authority bits in the 
authority table. 



ASN-Second-Table Entry 



ASN AUTHORIZATION 



ASN authorization is the process of 
testing whether the program associated 
with the current authorization index is 
permitted to establish a particular 
address space. The ASN authorization is 
performed as part of PROGRAM TRANSFER 
with space switching (PT-ss) and SET 
SECONDARY ASN with space switching 
(SSAR-ss) and may be performed as part 
of LOAD ADDRESS SPACE PARAMETERS. ASN 
authorization is performed after the 
ASN-translati on process for these 
i nstruct i ons. 



The ASN-second-table entry which is 
fetched as part of the ASN translation 
process contains information which is 
used to designate the authority table. 
An entry in the ASN second table has the 
following format: 



ATO 



00 



31 



ATL 



0000 



32 



48 



60 



64 



When performed as part of PT-ss, the ASN 
authorization tests whether the ASN can 
be established as the primary ASN and is 
called primary-ASN authorization. When 
performed as part of LOAD ADDRESS SPACE 
PARAMETERS or SSAR-ss, the ASN authori- 



(ATO) 



Authori ty-Table Ori gi n 

1-29, with two zeros appended on 

right, are used to form a 

address that designates the 

the authority table. 



Bits 

the 

31-bit real 

beginning of 
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Authori ty-Table Entri es 



The authority table consists of entries 
of two bits each; accordingly, each byte 
of the authority table contains four 
entries in the following format: 



PS 


PS 


PS 


PS 



The fields are allocated as follows: 

Primary Authori ty (P) : The left bit of 
an authority-table entry controls wheth- 
er the program with the authorization 
index corresponding to the entry is 
permitted to establish the address space 
as a primary address space. If the P 
bit is one, the access is permitted. If 
the P bit is zero, the access is not 
permi tted. 

Secondary Authori ty (S) : The right bit 
of an authority-table entry controls 
whether the program with the correspond- 



ing authorization index is permitted to 
establish the address space as a second- 
ary address space. If the S bit is one, 
the access is permitted. If the S bit 
is zero, the access is not permitted. 



ASN-AUTHORIZATION PROCESS 



This section describes the ASN- 
authori zati on process as it is performed 
during the execution of PROGRAM TRANSFER 
with space switching and SET SECONDARY 
ASN with space switching. For these two 
instructions, the ASN-authori zat i on 
process is performed by using the 
authorization index currently in control 
register 4. Secondary authorization for 
LOAD ADDRESS SPACE PARAMETERS is the 
same, except that the value which will 
become the new contents of control 
register 4 is used for the authorization 
index, and a secondary-authority excep- 
tion does not occur. Instead, such a 
situation is indicated by the condition 
code. 
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CR4 AX 



(xl/4) 



ASN Second Table 












ASN-Second-Table Entry 
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ATO 





AX 


ATL 





STD 


LTD 




(x4) 



+ I 

— » — . — 
R PS 



Authority Table 



For primary ASN authorization (PT-ss only): 
Primary-authority exception if P bit 
zero or table length exceeded. 

For secondary ASN authorization (SSAR-ss only) 
Secondary-authority exception if S bit 
zero or table length exceeded. 



For secondary ASN authorization 
Set condition code 2 if S bit 
table length exceeded. 



(LASP only): 
zero or 



R: Address is real 



ASN Authorization 



Authori ty-Table Lookup 

The authorization index, in conjunction 
with the authority-table origin 
contained in the ASN-second-table entry, 
is used to select an entry from the 
authority table. 

The authorization index is contained in 
bit positions 0-15 of control register 
4. 

Bit positions 1-31 of the AST entry 
contain the 31-bit real address of the 
authority table (ATO), and bit positions 
48-59 contain the length of the authori- 
ty table (ATL). 

The 31-bit real address of a byte in the 
authority table is obtained by appending 
two zeros on the right to the 



authority-table origin and adding the 14 
leftmost bits of the authorization index 
with 17 zeros appended on the left. A 
carry, if any, into bit position is 
ignored. All 31 bits of the address are 
used, regardless of whether the current 
PSU specifies the 24-bit or 31-bit 
addressing mode. 

As part of the authority-table-entry- 
lookup process, bits 0-11 of the author- 
ization index are compared against the 
authority-table length. If the compared 
portion is greater than the authority- 
table length, a primary-authority 
exception or secondary-authority excep- 
tion is recognized for PT-ss or SSAR-ss, 
respectively. For LOAD ADDRESS SPACE 
PARAMETERS, when the authority-table 
length is exceeded, condition code 2 is 
set. 
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The fetch access to the byte i n the 
authority table is not subject to 
protection. When the storage address 
which is generated for fetching the byte 
designates a location which is not 
available in the configuration* an 
addressing exception is recognized, and 
the operation is suppressed. 

The byte contains four authority-table 
entries of two bits each. The rightmost 
two bits of the authorization index, 
bits 14 and 15 of control register 4, 
are used to select one of the four 
entries. The left or right bit of the 
entry is then tested, depending on 
whether the authorization test is for a 
primary ASN or a secondary ASN. The 
following table shows the bit which is 
selected from the byte as a function of 
bits 14 and 15 of the authorization 
index and the instruction PT-ss, 
SSAR-ss, or LOAD ADDRESS SPACE PARAME- 
TERS. 



Authori zati on- 
Index Bits 

14 15 


Bit Selected from 
Authority-Table Byte 
for Test 


P Bit 
(PT-ss) 


S Bit 
(SSAR-ss 
or LASP) 




1 

1 
1 1 



2 
4 
6 


1 
3 

5 
7 



If the selected bit 
authorized, and 
address-space-control 
the AST entry are loa 
priate control reg 
selected bit is zer 
authorized, and a 
exception or seconda 
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respectively. For L 
PARAMETERS, when the 
ized, condition code 



is one, the ASN is 
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parameters from 
ded into the appro- 
isters. If the 
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primary-authority 
ry-authority excep- 
r PT-ss or SSAR-ss, 
OAD ADDRESS SPACE 
ASN i s not authoi — 
2 is set. 



Recogni ti on of 
Authori zati on 



Excepti ons duri ng ASN 



The exceptions which can be encountered 
during the primary- and secondary-ASN- 
authori zati on processes and their prior- 
ities are described in the definitions 
of the instructions in which A£N author- 
ization is performed. 



Programmi ng Note 



The primary- and secondary-authority 
exceptions cause nullification in order 
to permit dynamic modification of the 
authority table. Thus, when an address 
space is created or "swapped in," the 
authority table can first be set to all 
zeros and the appropriate authority bits 
set to one only when required. 



DYNAMIC ADDRESS TRANSLATION 



Dynamic address translation (DAT) 
provides the ability to interrupt the 
execution of a program at an arbitrary 
moment, record it and its data in auxil- 
iary storage, such as a 
storage device, and at 
return the program and 
different main-storage 
resumption of execution. 

and its data 

storage may 



di rect-access 

a later time 

the data to 

locations for 

The transfer 

between main 

be performed 



of the program 
and auxi liary 
piecemeal, and the return of the infoi — 
mation to main storage may take place in 
response to an attempt by the CPU to 
access it at the time it is needed for 
execution. These functions may be 
performed without change or inspection 
of the program and its data, do not 
require any explicit programming conven- 
tion for the relocated program, and do 
not disturb the execution of the program 
except for the time delay involved. 

With appropriate support by an operating 
system, the dynamic-address-translation 
facility may be used to provide to a 
user a system wherein storage appears to 
be larger than the main storage which is 
available in the configuration. This 
apparent main storage is referred to as 
virtual storage, and the addresses used 
to designate locations in the virtual 
storage are referred to as virtual 
addresses. The virtual storage of a 
user may far exceed the size of the main 
storage which is available in the 
configuration and normally is maintained 
in auxiliary storage. The virtual stor- 
age occurs in blocks of addresses, 
called pages. Only the most recently 
referred-to pages of the virtual storage 
are assigned to occupy blocks of phys- 
ical main storage. As the user refers 
to pages of virtual storage that do not 
appear in main storage, they are brought 
in to replace pages in main storage that 
&re less likely to be needed. The swap- 
ping of pages of storage may be 
performed by the operating system with- 
out the user's knowledge. 

The sequence of virtual addresses asso- 
ciated with a virtual storage is called 
an address space. With appropriate 
support by an operating system, the 
dynamic-address-translation facility may 
be used to provide a number of address 
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dynamic address translation provides for 
the translation of virtual addresses 
from two different address spaces with- 
out requiring that the translation 
parameters in the control registers be 
changed. These two address spaces are 
called the primary address space and the 
secondary address space. 

In the process of replacing blocks of 
main storage by new information from an 
external medium, it must be determined 
which block to replace and whether the 
block being replaced should be recorded 
and preserved in auxiliary storage. To 
aid in this decision process, a refei — 
ence bit and a change bit are associated 
with the storage key. 

Dynamic address translation may be spec- 
ified for instruction and data addresses 
generated by the CPU but is not avail- 
able for the addressing of data and of 
CCWs and I DAW 5 in I/O operations. The 
CCW-i ndi rect-data-addressi nq facility i 5 
provided to ajd I/O operations in a 



vi rtual-storage e n v 1 r o n m enT T 

Address computation can be carried out 
in either the 24-bit or 31-bit address- 
ing mode. When address computation is 
performed in the 24-bit addressing mode, 
seven zeros are appended on the left to 
form a 31-bit address. Therefore, the 
resultant logical address is always 31 
bits in length. All real and absolute 
addresses are 31 bits in length. 

Dynamic address translation is the proc- 
ess of translating a virtual address 
during a storage reference into the 
corresponding real address. When DAT is 
off, the logical address is treated as a 
real address. When DAT is on, the 
virtual address may be either a primary 
virtual address or a secondary virtual 
address. Primary virtual addresses are 
translated by means of the primary 
segment-table designation and secondary 
virtual addresses by means of the 
secondary segment-table designation. 
After selection of the appropriate 
segment-table designation, the trans- 
lation process is the same for both 
types of virtual address. 



In the process 
of units 
recognized — 



of translation, two types 
of information are 
segments and pages. A 



sp anni n< 
l H-by T e ' 



h i n g a t a 1 M - By ¥e ~ t o u n da r y . A page 1 5 a 
block of sequential virtual addresses 
spanning _4ft hyto«i. and beginning at a 
4K~byte boundary. 

The virtual address, accordingly, is 
divided into three fields. Bits 1-11 
are called the segment index (SX), bits 
12-19 are called the page index (PX), 
and bits 20-31 are called the byte index 
(BX). The virtual address has the 
following format: 



/ 


SX 


PX 


BX 



12 
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Address tra nslation is controlled 

referrea "t"oT as the t ran slat i on .parame- 
ters, in control r eg i _ iSf 'f? _!"' s'"' *07" , "T~, "and 7 . 

A'cfdTti onal controls are located in the 
translation tables. 



Translati on Modes 



The two bits in the PSW that control 
dynamic address translation are bit 5, 
the DAT-mode bit, and bit 16, the 
address-space-control bit. When the 
DAT-mode bit is zero, DAT is off, the 
CPU is said to be in the real mode, and 
instruction and logical addresses are 
treated as real addresses. When the 
DAT-mode bit is one (DAT is on) and the 
address-space-control bit is zero, the 
CPU is said to be in the primary-space 
mode, and instruction and logical 
addresses are treated as primary virtual 
addresses. When DAT is on and the 
address-space-control bit is one, the 
CPU is said to be in the secondary-space 
mode, and logical addresses are treated 
as secondary virtual addresses. The 
various modes are shown in the figure 
"Translation Modes." 
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Programmi ng Notes 



Predictable program operation is 
ensured in the secondary-space mode 
only when the instructions are 
fetched from virtual-address 
locations which translate to the 
same real address by means of both 
the primary and secondary segment 
tables. Thus, a program should not 
enter the secondary-space mode 
unless the aforementioned condi- 
tions exist. 

The requirement limiting when the 
CPU can change the address space 
used for fetching instructions 
eliminates problems with CPU retry, 
DAT pretesting, and trial execution 
of instructions for the purposes of 
determining PER events. 



Control Regi ster 0. 



Six bits are provided in control regis- 
ter which are used in controlling 
dynamic address translation. The bits 
are assigned as follows: 



TF 



13 



Secondary- Space Control (D) : Bit 5 of 
control register is the secondary- 
space-control bit. When this bit is 



zero and execution of MOVE TO PRIMARY, 
MOVE TO SECONDARY, or SET ADDRESS SPACE 
CONTROL is attempted, a special- 
operation exception is recognized. When 
this bit is one, it indicates that the 
secondary segment table is attached when 
the CPU is in the primary-space mode. 

Translation Format (J_F) : Bits 8-12 of 
control register specify the trans- 
lation format, with only one combination 
of the five control bits valid; all 
other combinations are invalid. 

The control bits are encoded as follows: 



Bits of Control Register 


Valid 


8 


9 


10 


11 


12 


10 11 
All others 


Yes 
No 



When an invalid bit combination is 
detected in bit positions 8-12, a 
translation-specification exception is 
recognized as part of the execution of 
an instruction using address transla- 
tion. 



Control Regi ster 1. 



Control register 1 contains the primary 
segment-table designation (PSTD). The 
register has the following format: 



X 


Primary Segment- 
Table Origin 




PSTL 



20 



25 



31 



Space-Swi tch-Event-Control Bi t (X) : 
When bit of control register 1 is one 
and execution of PROGRAM CALL with space 
switching (PC-ss) or PROGRAM TRANSFER 
with space switching (PT-ss) is 
completed, a space-switch-event program 
interruption occurs. The space-switch- 
event-control bit is also examined by 
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LOAD ADDRESS SPACE PARAMETERS, and, if 
it is one, condition code 3 is set. 

Primary Segment-Table Origi n ( PSTO ) : 
Bits 1-19 of control register i, with 12 
zeros appended on the right, form an 
address that designates the beginning of 
the primary segment table. It is unpre- 
dictable whether the address is real or 
absolute. This table is called the 
primary segment table since it is used 
to translate virtual addresses in the 
primary address space. 

Primary Segment-Table Length (PSTL.) : 
Bits 25-31 of control register 1 specify 
the length of the primary segment table 
in units of 64 bytes, thus making the 
length of the segment table variable in 
multiples of 16 entries. The length of 
the primary segment table, in units of 
64 bytes, is one more than the PSTL 
value. The contents of the length field 
are used to establish whether the entry 
designated by the segment- index portion 
of a primary virtual address falls with- 
in the primary segment table. 

Bits 20-24 of control register 1 are not 
assigned and are ignored. 



Bits and 20-24 of control register 7 
are not assigned and are ignored. 



Programming Notes 



The validity of the information 
loaded into a control register, 
including that pertaining to dynam- 
ic address translation, is not 
checked at the time the register is 
loaded. This information is 
checked and the program exception, 
if any, is indicated at the time 
the information is used. 

The information pertaining to 
dynamic address translation is 
considered to be used when an 
instruction is executed with DAT on 
or when INVALIDATE PAGE TABLE ENTRY 
or LOAD REAL ADDRESS is executed. ( 
The information is not considered 
to be used when the PSW specifies 
translation but an I/O, external, 
restart, or machine-check inter- 
ruption occurs before an instruc- 
tion is executed, or when the PSW 
specifies the wait state. 



Control Regi ster T_ 



Control register 7 contains the second- 
ary segment-table designation (SSTD), 
The register has the following formats 





Secondary Segment- 
Table Origin 




SSTL 



20 



25 



31 



Secondary Segment-Table Origin ( SSTO ) : 
Bits 1-19 of control register 7, with 12 
zeros appended on the right, form an 
address that designates the beginning of 
the secondary segment table. It is 
unpredictable whether the address is 
real or absolute. This table is called 
the secondary segment table since it is 
used to translate virtual addresses in 
the secondary address space. 



Secondary Segment-Table Length ( SSTL ) : 
Bits 25-31 of control register 7 specify 
the length of the secondary segment 
table in units of 64 bytes, thus making 
the length of the segment table variable 
in multiples of 16 entries. The length 
of the secondary segment table, in units 
of 64 bytes, is one more than the SSTL 
value. The contents of the length field 
are used to establish whether the entry 
designated by the segment-index portion 
of a secondary virtual address falls 
within the secondary segment table. 



TRANSLATION TABLES 



The translation process consists in a 
two-level lookup using two tables: a 
segment table and a page table. These 
tables reside in real or absolute stor- 
age. 



Segment-Table Entries 



The entry fetched from the segment table 
has the following formats 






Page-Table Origin 


I 


C 


PTL 



1 26 28 31 

The fields in the segment-table entry 
are allocated as follows: 

Page-Table Origin ( PTO ): Bits 1-25, 
with six zeros appended on the right, 
form the address that designates the 
beginning of a page table. It is unpre- 
dictable whether the address is real or 
absolute. 

Segment-Invalid Bit (I.): Bit 26 
controls whether the segment associated 
with the segment-table entry is avail- 
able. When the bit is zero, address 
translation proceeds by using the 
segment-table entry. Ulhen the bit is 
one, the segment-table entry cannot be 
used for translation. 
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Common-Segment Bi t (C) '- Bit 27 controls 
the use of the translation-lookaside- 
buffer (TLB) copies of the segment-table 
entry and of the page table which it 
designates. A zero identifies a private 
segment; in this case, the segment-table 
entry and the page table it designates 
may be used only in association with the 
segment-table origin that designates the 
segment table in which the segment-table 
entry resides. A one identifies a 
common segment; in this case, the 
segment-table entry and the page table 
it designates may continue to be used 
for translating addresses corresponding 
to the segment index, even though a 
different segment table is specified. 

Page-Table Length (PTL): Bits 28-31 
specify the length of the page table in 
units of 64 bytes (16 entries). The 
length of the page table, in units of 64 
bytes, is one more than the PTL value. 
The contents of the length field are 
used to establish whether the entry 
designated by the page-index portion of 
the virtual address falls within the 
page table. 

Bit of the segment-table entry must be 
zero; if it is not zero, a translation- 
specification exception is recognized as 
part of the execution of an instruction 
using that entry for address transla- 
tion. 



Page-Frame Real Address (PFRA): Bits 

1-19 provide the leftmost bits of a real 

storage address. When these bits are 
concatenated with the 12-bit byte-index 

field of the virtual address on the 

right, a 31-bit real address is 
obtai ned. 



Page-Invali d 
whether the 



Page-Table Entri es 



Bit (I): Bit 21 controls 
page associated with the 
page-table entry is available. When the 
bit is zero, address translation 
proceeds by using the page-table entry. 
When the bit is one, the page-table 
entry cannot be used for translation. 

Page-Protection Bit (P) : Bit 22 con- 
trols whether store accesses can be made 
in the page. This protection mechanism 
is in addition to the key-controlled- 
protection and low-address-protection 
mechanisms. The bit has no effect on 
fetch accesses. If the bit is zero, 
stores are permitted to the page, 
subject to the other protection mech- 
anisms. If the bit is one, stores are 
disallowed. An attempt to store when 
the page-protection bit is one causes a 
protection exception to be recognized. 

Bit positions 0, 20, and 23 of the entry 
must contain zeros; otherwise, a 
translation-specification exception is 
recognized as part of the execution of 
an instruction using that entry for 
address translation. Bit positions 
24-31 are unassigned and are not checked 
for zeros; thus, they are available for 
programming use. 



The entry fetched from the page table 
entry has the following format J 






PFRA 





I 


P 





//////// 



1 



20 



24 



31 



The fields in the page-table entry are 
allocated as follows: 



Summary of Segment-Table and Page-Table 
Si zes 



The sizes of segment tables and page 
tables are summarized in the figure 
"Sizes of Segment Tables and Page 
Tables." 
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Segment-Table Parameters 


Virtual 
Address 

Si ze 
(Bits) 


Number of 
Addressable 
Segments 


Corresponding 
Segment Table 


Segment- 
Table 
Increment 
(Bytes) 


Maximum 
Size (Bytes) 


Usable 
Length Code 


24 1 
31 


16 
2,048 


64 
8,192 



127 


64 



Page-Table Parameters 2 


Number of 

Pages 
in Segment 


Correspondi ng 
Page Table 


Page- 
Table 
Increment 
(Bytes) 


Maximum 
Size (Bytes) 


Usable 
Length Code 


256 


1,024 


15 


64 



Explanati on ? 

1 A virtual address specified by the program in the 
24-bit addressing mode consists of a 24-bit value 
embedded in a 31-bit address. 

2 The page-table size is independent of the virtual 
address size. 



Sizes of Segment Tables and Page Tables 



TRANSLATION PROCESS 



Effective Segment-Table Designati on 



This section describes the translation 
process as it is performed implicitly 
before a virtual address is used to 
access main storage. The process of 
translating the operand address of LOAD 
REAL ADDRESS and TEST PROTECTION is the 
same, except that segment-translation 
and page-translation exceptions do not 
occur; such situations are instead indi- 
cated in the condition code. 
Translation of the operand address of 
LOAD REAL ADDRESS also differs in that 
the CPU may be in the real mode and the 
translation-lookaside buffer is not 
used. 



Translation of a vi 
performed by means of 
and a page table both 
real or absolute 
controlled by the DAT 
address- space-control 
PSW. The translation 
fied by the translat 
control regi sters 1 an 



rtual address is 
a segment table 
of which reside in 
storage. It is 
-mode bit and the 
bit, both in the 
tables are speci- 
i on parameters in 
d 7. 



The segment-table designation used for a- 
particular address translation is called 
the effective segment-table designation. 
Accordingly, when a primary virtual 
address is translated, control register 
1 is used as the effective segment-table 
designation, and when a secondary virtu- 
al address is translated, control 
register 7 is used as the effective 
segment-table designation. 

The segment-index portion of the virtual 
address is used to select an entry from 
the segment table, the starting address 
and length of which are specified by the 
effective segment-table designation. 
This entry designates the page table to 
be used. 

The page-index portion of the virtual 
address is used to select an entry from 
the page table. This entry contains the 
leftmost bits of the real address that 
represents the translation of the virtu- 
al address and provides the page- 
protection bit. 

The byte-index field of the virtual 
address is used unchanged as the right- 
most bit positions of the real address. 
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If the I bit is one in either the 
segment-table entry or the page-table 
entry* the entry is invalid, and the 
translation process cannot be completed 
for this virtual address. A segment- 
translation or a page-translation 
exception is recognized. 

In order to eliminate the delay associ- 
ated with references to translation 
tables in real or absolute storage, the 
information fetched from the tables 
normally is also placed in a special 
buffer, the translation-lookaside buffer 
(TLB), and subsequent translations 
involving the same table entries may be 



performed by using 
recorded in the TLB. 
the TLB is described 
"Translation-Lookasi de 
chapter . 



the information 

The operation of 

in the section 

Buffer" in this 



Whenever access to real or absolute 
storage is made during the address- 
translation process for the purpose of 
fetching an entry from a segment table 
or page table, key-controlled protection 
does not apply. 

The translation process, including the 
effect of the TLB, is shown graphically 
in the figure "Translation Process." 
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Control Register 1 Control Register 7 



Virtual Address 



PSTD 



SSTD 



* 1 * 






-« — • — »- 



Effective STD 



STO 



STL 



(x4096) 







Segment Table 



R/A 



PTO 



PTL 



(x64) 







Page Table 



R/A 



PFRA 



(x4) 






SX PX BX 



-4 • » 










R/A: Address is either real or absolute 



(x4) 



Translati on 
Lookasi de 
Buffer (TLB) 



PFRA 



.♦0 







l r 



Real Address 



Translation Process (Part 1 of 2) 
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Control register 1 provides the primary segment-table designation for 
translation of a primary virtual address, and control register 7 
provides the secondary segment-table designation for translation of a 
secondary virtual address. 



2 Information, which may include portions of the virtual address and the 
' — ' effective segment-table origin, is used to search the TLB. 








If a match exists, the page-frame real address from the TLB is used in 
forming the real address. 

If no match exists, table entries in real or absolute storage are fetched. 

The resulting fetched entries, in conjunction with the search information, 

are used to translate the address and may be used to form an entry in the 
TLB. 



Translation Process (Part 2 of 2) 



\ 



1 



Inspecti on of Control Regi ster 0. 



The interpretation of the virtual 
address for translation purposes 
requires that there be a valid trans- 
lation format specified by bits 8-12 of 
control register 0. If bits 8-12 
contain an invalid code, a translation- 
specification exception is recognized. 



segment-translation exception 
ni zed. 



i s recog- 



Seqment-Table Lookup 



The segment-index portion of the virtual 
address, in conjunction with the 
segment-table origin contained in the 
effective segment-table designation, is 
used to select an entry from the segment 
table. 

The 31-bit address of the segment-table 
entry in real or absolute storage is 
obtained by appending 12 zeros to the 
right of bits 1-19 of the effective 
segment-table designation and adding the 
segment index with two rightmost and 18 
leftmost zeros appended. When a carry 
into bit position occurs during the 
addition, an addressing exception may be 
recognized or the carry may be ignored, 
causing the table to wrap from 2 3X - 1 
to zero. All 31 bits of the address are 
used, regardless of whether the current 
PSW specifies the 24-bit or 31-bit 
addressing mode. 

As part of the segment-table-lookup 
process, bits 1-7 of the virtual address 
are compared against the segment-table 
length, bit positions 25-31 of the 
effective segment-table designation, to 
establish whether the addressed entry is 
within the segment table. If the value 
in the segment-table-length field is 
less than the value in the corresponding 
bit positions of the virtual address, a 



All four bytes of the segment-table 
entry appear to be fetched concurrently 
as observed by other CPUs. The fetch 
access is not subject to protection. 
When the storage address generated for 
fetching the segment-table entry desig- 
nates a location which is not available 
in the configuration, an addressing 
exception is recognized, and the unit of 
operation is suppressed. 

Bit 26 of the entry fetched from the 
segment table specifies whether the 
corresponding segment is available. 
This bit is inspected, and, if it is 
one, a segment-translation exception is 
recognized. If bit of the entry is 
one, a translation-specification excep- 
tion is recognized. 

When no exceptions are recognized in the 
process of segment-table lookup, the 
entry fetched from the segment table 
designates the beginning and specifies 
the length of the corresponding page 
table. 

The common-segment bit, bit 27 of an 
entry fetched from the segment table, is 
used only for the purpose of forming a 
TLB entry (see the section "Use of the 
Translation-Lookaside Buffer" later in 
this chapter). 



Page-Table Lookup 



The page-index portion of the virtual 
address, in conjunction with the 
page-table origin contained in the 
segment-table entry, is used to select 
an entry from the page table. 

The 31-bit address of the page-table 
entry in real or absolute storage is 
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obtained by appending six zeros to the 
right of the page-table origin and 
adding the page index, with two right- 
most and 21 leftmost zeros appended. A 
carry into bit position may cause an 
addressing exception to be recognized, 
or the carry may be ignored, causing the 
page table to wrap from 2 31 - 1 to zero. 
All 31 bits of the address are used, 
regardless of whether the current PSW 
specifies the 24-bit or 31-bit address- 
ing mode. 

As part of the page-table-lookup 
process, the four leftmost bits of the 
page index are compared against the 
page-table length, bits 28-31 of the 
segment-table entry, to establish wheth- 
er the addressed entry is within the 
table. If the value in the page-table- 
length field is less than the value in 
the four leftmost bit positions of the 
page-index field, a page-translation 
exception is recognized. 



All four bytes of the 
appear to be fetched 
observed by other 
access is not subjec 
When the storage addr 
fetching the page-tabl 
a location which is no 
configuration, an add 
is recognized, and the 
is suppressed. 



page-table entry 
concurrently as 
CPUs. The fetch 
t to protection, 
ess generated for 
e entry designates 
t available in the 
ressing exception 
unit of operation 



can cause exceptions to be recognized 
during the translation process. 
Exceptions are recognized when informa- 
tion contained in control registers or 
table entries is used for translation 
and is found to be incorrect. 

The information pertaining to DAT is 
considered to be used when an instruc- 
tion is executed with DAT on or when 
INVALIDATE PAGE TABLE ENTRY or LOAD REAL 
ADDRESS is executed. The information is 
not considered to be used when the PSW 
specifies DAT on but an I/O, external, 
restart, or machine-check interruption 
occurs before an instruction is 
executed, or when the PSW specifies the 
wait state. Only that information 
required in order to translate a virtual 
address is considered to be in use 
during the translation of that address, 
and, in particular, addressing 
exceptions that would be caused by the 
use of the PSTD or the SSTD are not 
recognized when the translation of an 
address uses only the SSTD or only the 
PSTD, respectively. 

A list of translation exceptions, with 
the action taken for each exception and 
the priority in which the exceptions are 
recognized when more than one is appli- 
cable, is provided in the section 
"Recognition of Access Exceptions" in 
Chapter 6, "Interruptions." 



The entry fetched from the page 
indicates the availability of th 
and contains the leftmost bits o 
page-frame real address. The 
invalid bit is inspected to est 
whether the corresponding page is 
able. If this bit is one, a 
translation exception is recognize 
bit position 0, 20, or 23 conta 
one, a translation-specification 
tion is recognized. 



Formation of the Real Address 



table 
e page 
f the 

page- 
abli sh 
avai 1- 

page- 
d. If 
i ns a 
excep- 



When no exceptions in th 
process are encountered, 
real address obtained fr 
table entry and the byte 
of the virtual address are 
with the page-frame real a 
the leftmost part. The 
real storage address whic 
to the virtual address, 
the address are used, 
whether the current PSW 
24-bit or 31-bit addressin 



e translation 
the page-frame 
om the page- 
-index portion 
concatenated, 
ddress forming 
result is the 
h corresponds 
All 31 bits of 
regardless of 
specifies the 
g mode. 



Recogni ti on of Except i ons during Trans- 
lati on 



Invalid addresses and invalid formats 



TRANSLATION-LOOKASIDE BUFFER 



To enhance performance, the dynamic- 
address-translation mechanism normally 
is implemented such that some of the 
information specified in the segment and 
page tables is maintained in a special 
buffer, referred to as the translation- 
lookaside buffer (TLB). The CPU neces- 
sarily refers to a DAT-table entry in 
real or absolute storage only for the 
initial access to that entry. This 
information may be placed in the TLB, 
and subsequent translations may be 
performed by using the information in 
the TLB. The presence of the TLB 
affects the translation process to the 
extent that a modification of the 
contents of a table entry in real or 
absolute storage does not necessarily 
have an immediate effect, if any, on the 
translation. 

The size and the structure of the TLB 
depend on the model. For instance, the 
TLB may be implemented in such a way as 
to contain only a few entries pertaining 
to the currently designated segment 
table, each entry consisting of the 
leftmost portion of a virtual address 
and its corresponding page-frame real 
address and page-protection bit; or it 
may contain arrays of values where the 
page-frame real address and page- 
protection bit are selected on the basis 
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of the effective segment -table origin 
and the leftmost bits of the virtual 
address. Entries within the TLB are not 
explicitly addressable by the program. 
In a multiple-CPU configuration, each 
CPU has its own TLB. 

The description of the logical structure 
of the TLB covers the implementation by 
all systems operating in the 370-XA 
mode. The TLB entries are considered as 
being of two types: TLB segment-table 
entries and TLB page-table entries. A 
TLB entry is considered as containing 
within it both the information obtained 
from the table entry in real or absolute 
storage and the attributes used to fetch 
the entry from storage. Thus, a TLB 
segment-table entry would contain the 
following fields: 



fields are 



not 



page- table- length 
requi red. 

Note ? The following sections describe 
the conditions under which information 
may be placed in the TLB and information 
from the TLB may be used for address 
translation, and they describe how 
changes to the translation tables affect 
the translation process. Information is 
not necessarily retained in the TLB 
under all conditions for which such 
retention is permissible. Furthermore, 
information in the TLB may be cleared 
under conditions additional to those for 
which clearing is mandatory. 



Use of the T ran slat i on-Lookasi de Buffer 



5T0 


SX 


PTO 


PTL 


C 



STO 

SX 

PTO 

PTL 



The segment-table origin in effect 
when the entry was formed 



The segment 
the entry 



index used to select 



The page-table origin fetched from 
the segment-table entry in real or 
absolute storage 

The page-table length fetched from 
the segment-table entry in real or 
absolute storage 

The common-segment bit fetched 
from the segment-table entry in 
real or absolute storage 



A TLB page-table entry would contain the 
following fields: 



PTO 


PX 


PFRA 


P 



PTO The page-table origin in 
when the entry was formed 



effect 



PX The page index used to select the 
entry 

PFRA The page-frame real address 
fetched from the page-table entry 
in real or absolute storage. 

P The page-protection bit fetched 
from the page-table entry in real 
or absolute storage 

Depending on the implementation, not all 
of the above items are required in the 
TLB. For example, if the implementation 
combines into a single TLB entry (1) the 
information obtained from a page-table 
entry and (2) the attributes of both the 
page-table entry and the segment-table 
entry, then the page-table-origin and 



The formation of TLB ent 
effect of any manipulat 
contents of a table entry 
absolute storage by the p 
on whether the entry is val 
er the entry is attached to 
CPU, on whether a copy of 
be placed in the TLB of 
CPU, and on whether a copy 
the entry is usable. 



ries and the 
ion of the 
in real or 
rogram depend 
id, on wheth- 
a particular 
the entry can 
a particular 
in the TLB of 



The vali d state of a table entry denotes 
that the segment or page associated with 
the table entry is available. An entry 
is valid when the segment-invalid bit or 
page-invalid bit in the entry is zero. 

The attached state of a table entry 
denotes that the CPU to which it is 
attached can attempt to use the table 
entry for implicit address translation. 
The table entry may be attached to more 
than one CPU at a time. When a table 
entry is described as attached, the term 
"to a CPU" is implied. 

The usable state of a TLB entry denotes 
that the CPU can attempt to use the TLB 
entry for implicit address translation. 
Also, the usable state of a TLB 
segment-table entry is a factor in 
determining whether a page-table entry 
is attached. 

A segment-table entry or a page-table 
entry may be placed in the TLB only when 
the entry is attached and valid and 
would not cause a translation- 
specification exception if used for 
translation. Except for these 
restrictions, the entry may be placed in 
the TLB at any time. 

A segment-table entry is attached when 
all of the following conditions are met: 

1. The current PSW specifies DAT on. 

2. The current PSW contains no errors 
which would cause an early excep- 
tion to be recognized. 
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The current 
bits 8-12 in 
valid. 



translation format/ 
control register , is 



in the TLB entry matches the segment- 
table origin used to select it. 



The entry meets the requirements in 
a or b below. 

a. The entry is within the segment 
table designated by the primary 
segment-table designation in 
control register 1. 

b. The entry is within the segment 
table designated by the second- 
ary segment-table designation 
in control register 7 and 
either of the following 
requirements is met: 



The CPU 
secondary 



l s 
space 



in 
mode. 



the 



• The secondary-space con- 
trol, bit 5 of control 
register 0, is one. 

A page-table entry is attached when it 
is within the page table designated by 
either a usable TLB segment-table entry 
or by an attached and valid segment- 
table entry which would not cause a 
translation-specification exception if 
used for translation. 

A TLB segment-table entry is in the 
usable state when all of the following 
conditions are met: 



1. 
2. 



The current PSW specifies DAT on. 

The current PSW contains no errors 
which would cause an early excep- 
tion to be recognized. 

The current translation format* 
bits 8-12 in control register 0/ is 
valid. 

The TLB segment-table entry meets 
at least one of the following re- 
qui rements: 



The common-segment 
in the TLB entry. 



bit is one 



• The segment-table-origin field 
in the TLB entry is the same as 
the current PSTO. 

• The segment-table-origin field 
in the TLB entry is the same as 
the current SSTO, and either 
PSW bit 16 is one or bit 5 of 
control register is one. 

A TLB segment-table entry may be used 
for implicit address translation only 
when the entry is in the usable state, 
the segment index of the entry matches 
the segment index of the virtual address 
to be translated, and either the 
common-segment bit is one in the TLB 
entry or the segment-table-origin field 



A TLB page-table entry 
state when all of the 
tions are met: 



is in the usable 
following condi- 



The TLB page-table 

selected by a usable 

table entry or by an 

valid segment-table 

would not cause a 

specification exception if used for 

translati on. 



entry is 
TLB segment- 
attached and 
entry which 
translati on- 



2. The page-table-origin field in the 
TLB page-table entry matches the 
page-table-origin field in the 
segment-table entry which selects 
it. 

3. The page-index field in the TLB 
page-table entry is within the 
range permitted by the page-table- 
length field in the segment-table 
entry which selects it. 

A TLB page-table entry may be used for 
implicit address translation only when 
the TLB entry is in the usable state as 
selected by the segment-table entry 
being used and only when the page index 
of the TLB page-table entry matches the 
page index of the virtual address being 
translated. 

The operand address of LOAD REAL ADDRESS 
is translated without the use of the TLB 
contents. Translation in this case is 
performed by the use of the designated 
tables in real or absolute storage. 

Selected page-table entries are cleared 
from the TLB by means of the INVALIDATE 
PAGE TABLE ENTRY instruction. All 
information in the TLB is necessarily 
cleared only by execution of PURGE TLB, 
SET PREFIX, or CPU reset. 



Programming Notes 



Although a table entry may be 
copied into the TLB only when the 
table entry is both valid and 
attached, the copy may remain in 
the TLB even when the table entry 
itself is no longer valid or 
attached. 

No entries can be copied into the 
TLB when DAT is off because the 
table entries at this time &re not 
attached. In particular, trans- 
lation of the operand address of 
LOAD REAL ADDRESS, with DAT off, 
does not cause entries to be placed 
in the TLB. 

Conversely, when DAT is on, infor- 
mation may be copied into the TLB 
from all translation-table entries 
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that could be used for address 
translation, given the current 
translation parameters* the setting 
of the address-space-control bit, 
and the setting of the secondary- 
space-control bit. The loading of 
the TLB does not depend on whether 
the entry is used for translation 
as part of the execution of the 
current instruction, and such load- 
ing can occur when the wait state 
is specified. 



3. More than one copy of a table entry 
may exist in the TLB. For example, 
some implementations may cause a 
copy of a valid table entry to be 
placed in the TLB for each 
segment-table origin by which the 
entry becomes attached. 

4. The states and use of the DAT 
entries in both storage and in the 
TLB are summarized in the figure 
"Summary of DAT Entries." 



t 



State or Function 



STE is attached by means 
of PSTD (applies only to 
STE in storage) 



STE is attached by means 
of SSTD (applies only to 
STE in storage) 



STE in storage is usable 
for a particular instance 
of implicit translation 



STE can be placed in TLB 



STE in TLB is usable 



Conditions to Be Met 



STE in TLB is usable for 
a particular instance of 
implicit translation 



PTE is attached (applies 
only to PTE in storage) 



PTE in storage is usable 
for a particular instance 
of implicit translation 



• DAT on 

• No early PSW exception 

• TF valid 

■» STE in segment table defined by 
PSTD in CR1 

• DAT on 

• No early PSW exception 

• TF valid 

• STE in segment table defined by 
SSTD in CR7 

• PSW bit 16 one or bit 5 of CRO 
one 

• STE in segment table defined and 
attached by STD being used for 
the translation 

• STE selected by SX 

• STE attached 

• STE I bit zero 

• No TS 

• DAT on 

• No early PSW exception 

• TF valid 

• STE selectable by an STD: 

- C bit one, or 

- STO matches PSTO, or 

- STO matches SSTO, and PSW bit 
16 one or bit 5 of CRO one 

• DAT on 

• No early PSW exception 

• TF valid 

• STE selected by STD being used 
for the translation: 

- STO matches, or 

- C bit one 

• SX matches 

• PTE in page table defined by 
usable STE in the TLB, or de- 
fined by an STE that can be 
placed in the TLB 

• PTE attached by means of STE 
being used for the translation 

• PTE selected by PX 



Summary of DAT Entries (Part 1 of 2) 
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State or Function 



Conditions to Be Met 



PTE can be placed in TLB 



PTE in TLB is usable 



PTE in TLB is usable for 
a particular instance of 
implicit translation 



PTE attached 
PTE I bit zero 
No TS 

PTE selectable by a usable STE 
in the TLB or by an STE that 
can be placed in the TLB: 

- PTO matches and 

- PX within PTL 

PTE selected by STE being used 
for the translation: 

- PTO matches and 

- PX within PTL 
PX matches 



Explanati on : 



C bit Common-segment bit in STE. 

I bit Invalid bit in table entry. 

PSTD Primary segment-table designation. 

PSTO Primary segment-table origin. 

PTE Page-table entry. 

PTL Page-table length. 

PTO Page-table origin. 

PX Page index. 

SSTD Secondary segment-table designation. 

SSTO Secondary segment-table origin. 

STD Segment-table designation. 

STE Segment-table entry. 

STO Segment-table origin. 

SX Segment index. 

TF Translation format (control register 0, bits 8-12). 

TS Translation-specification exception. The condition 
"No TS" means that attempted use of the associated 
DAT-table entry would not cause a translation- 
specification exception. 



Summary of DAT Entries (Part 2 of 2) 



Modi f i cati on of Translation Tables 



When an attached art 
i s made vali d and 
the associated virt 
TLB, the change ta 
than the end of 
operation. Simila 
tached and valid 
attached and no u 
associated virtual 
TLB* the change ta 
than the end of 
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d invalid table entry 
no usable entry for 
ual address is in the 
kes effect no later 
the current unit of 
rly, when an unat- 
table entry is made 
sable entry for the 
address is in the 
kes effect no later 
the current unit of 



When a valid and 
changed, and wh 
cleared of ent 
substitution for 
i s made to ref e 
virtual address 
translation, un 
occur, to the fo 
of the new va 
instructions or 
an instruction. 



attached table entry is 
en, before the TLB is 
ries which qualify for 

that entry, an attempt 
r to storage by using a 
requiring that entry for 
predictable results may 
llowing extent. The use 
lue may begin between 
during the execution of 

including the instruc- 



tion that caused the change. Moreover, 
until the TLB is cleared of entries 
which qualify for substitution for that 
entry, the TLB may contain both the old 
and the new values, and it is unpredict- 
able whether the old or new value is 
selected for a particular access. If 
both old and new values of a segment- 
table entry are present in the TLB, a 
page-table entry may be fetched by using 
one value and placed in the TLB associ- 
ated with the other value. If the new 
value of the entry is a value which 
would cause an exception, the exception 
may or may not cause an interruption to 
occur. If an interruption does occur, 
the result fields of the instruction may 
be changed even though the exception 
would normally cause suppression or 
null i f i cati on. 



Entries are cleared from the TLB 
accordance with the following rules: 



i n 



All entries are cleared from the 
TLB by the execution of PURGE TLB 
and SET PREFIX and by CPU reset. 
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Selected entries are cleared from 
all TLBs in the configuration by 
the execution of INVALIDATE PAGE 
TABLE ENTRY by any of the CPUs in 
the configuration. 

Some or all TLB entries may be 
cleared at times other than those 
required by PURGE TLB, SET PREFIX, 
CPU reset, and INVALIDATE PAGE 
TABLE ENTRY. 



Programmi ng Notes 



Entries in the TLB may continue to 
be used for translation after the 
table entries from which they have 
been formed have become unattached 
or invalid. These TLB entries are 
not necessarily removed unless 
explicitly cleared from the TLB. 

A change made to an attached and 
valid entry or a change made to a 
table entry that causes the entry 
to become attached and valid is 
reflected in the translation proc- 
ess for the next instruction, or 
earlier than the next instruction, 
unless a TLB entry qualifies for 
substitution for that table entry. 
However, a change made to a table 
entry that causes the entry to 
become unattached or invalid is not 
necessarily reflected in the trans- 
lation process until the TLB is 
cleared of entries which qualify 
for substitution for that table 
entry. 



2. 



3. 



Exceptions associated with dynamic 
address translation may be estab- 
lished by a pretest for operand 
accessibility that is performed as 
part of the initiation of instruc- 
tion execution. Consequently, a 
segment-translation or page- 
translation exception may be 
indicated when a table entry is 
invalid at the start of execution 
even if the instruction would have 
validated the table entry it uses 
and the table entry would have 
appeared valid if the instruction 
was considered to process the opei — 
ands one byte at a time. 



A change made to an a 
entry, except to set 
zero or to alter the r 
of a page-table entry 
unpredictable results 
is used for translati 
TLB is cleared of a 
that entry. The use 
value may begi 
instructions or 
execution of an 
including the instr 
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When an 



4. 



instruction, such as MOVE (MVC), 
makes a change to an attached table 
entry, including a change that 
makes the entry invalid, and subse- 
quently uses the entry for 
translation, a changed entry is 
being used without a prior clearing 
of the entry from the TLB, and the 
associated unpredictability of 
result values and of exception 
recognition applies. 

Manipulation of attached table 
entries may cause spurious table- 
entry values to be recorded in a 
TLB. For example, if changes are 
made piecemeal, modification of a 
valid attached entry may cause a 
partially updated entry to be 
recorded, or, if an intermediate 
value is introduced in the process 
of the change, a supposedly invalid 
entry may temporarily appear valid 
and may be recorded in the TLB. 
Such an intermediate value may be 
introduced if the change is made by 
an I/O operation that is retried, 
or if an intermediate value is 
introduced during the execution of 
a single instruction. 

As another example, if a segment- 
table entry is changed to designate 
a different page table and used 
without clearing the TLB, then the 
new page-table entries may be 
fetched and associated with the old 
page-table origin. In such a case, 
execution of INVALIDATE PAGE TABLE 
ENTRY designating the new page- 
table origin will not necessarily 
clear the page-table entries 
fetched from the new page table. 

To facilitate the manipulation of 
translation tables, INVALIDATE PAGE 
TABLE ENTRY is provided, which sets 
the I bit in a page-table entry to 
one and clears all TLBs in the 
configuration of entries formed 
from that table entry. 

INVALIDATE PAGE TABLE ENTRY is 
useful for setting the I bit to one 
in a page-table entry and causing 
TLB copies of the entry to be 
cleared from the TLB of each CPU in 
the configuration. The following 
aspects of the TLB operation should 
be considered when using INVALIDATE 
PAGE TABLE ENTRY. (See also the 
programming notes following INVALI- 
DATE PAGE TABLE ENTRY.) 



a. INVALIDATE 
should be 
making any 
table entry 
the rightmos 
the selectiv 
of INVALIDAT 
may not clea 
the entry. 



PAGE TABLE ENTRY 
executed before 
change to a page- 
other than changing 
t byte; otherwise, 
e clearing portion 
E PAGE TABLE ENTRY 
r the TLB copies of 
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b. Invalidation of all the 
page-table entries within a 
page table by means of INVALI- 
DATE PAGE TABLE ENTRY does not 
necessarily clear the TLB of 
the copies^ if any* of the 
segment-table entry designating 
the page table. When it is 
desired to invalidate and clear 
the TLB of a segment-table 
entry* the rules in note 5 
below must be followed. 

c. When a large number of 
page-table entries are to be 
invalidated at a single time* 
the overhead involved in using 
PURGE TLB and in following the 
rules in note 5 below may be 
less than in issuing INVALIDATE 
PAGE TABLE ENTRY for each 
page-table entry. 

Manipulation of table entries 
should be in accordance with the 
following rules. If these rules 
are complied with/ translation is 
performed as if the table entries 
from real storage were always used 
in the translation process. 

a. A valid table entry must not be 
changed while it is attached to 
any CPU except either to inval- 
idate the entry/ by using 
INVALIDATE PAGE TABLE ENTRY or 
to alter bits 24-31 of a page- 
table entry. 

b. When any change is made to a 
table entry other than a change 
to bits 24-31 of a page-table 
entry/ each CPU which may have 
a TLB entry formed from that 
entry must execute PURGE TLB or 
SET PREFIX or perform CPU 
reset/ after the change occurs 
and prior to the use of that 
entry for implicit translation 
by that CPU, except that the 
purge is unnecessary if the 
change was made by using INVAL- 
IDATE PAGE TABLE ENTRY. 

c. When any change is made to an 
invalid table entry in such a 
way as to allow intermediate 
valid values to appear in the 
entry, each CPU to which the 
entry is attached must execute 
PURGE TLB or SET PREFIX or 
perform CPU reset/ after the 
change occurs and prior to the 
use of the entry for implicit 
address translation by that 
CPU. 

d. When any change is made to a 
segment-table or page-table 
length/ each CPU to which that 
table has been attached must 
execute PTLB after the length 



has been changed but before 
that table becomes attached 
again to the CPU. 

Note that when an invalid page- 
table entry is made valid without 
introducing intermediate valid 
values/ the TLB need not be cleared 
in a CPU which does not have any 
usable TLB copies for that entry. 
Similarly, when an invalid 
segment-table entry is made valid 
without introducing intermediate 
valid values/ the TLB need not be 
cleared in a CPU which does not 
have any usable TLB copies for that 
segment-table entry and which does 
not have any usable TLB copies for 
the page-table entries attached by 
it. 

The execution of PURGE TLB and SET 
PREFIX may have an adverse effect 
on the performance of some models. 
Use of these instructions should/ 
therefore/ be minimized in conform- 
ity with the above rules. 



ADDRESS SUMMARY 



ADDRESSES TRANSLATED 



Most addresses that are explicitly spec- 
ified by the program and are used by the 
CPU to refer to storage for an instruc- 
tion or an operand are logical addresses 
and are subject to implicit translation 
when DAT is on. Analogously, the corre- 
sponding addresses indicated to the 
program on an interruption or as the 
result of executing an instruction are 
logical. The operand address of LOAD 
REAL ADDRESS is explicitly translated/ 
regardless of whether the PSW specifies 
DAT on or off. 

Translation is not applied to quantities 
that are formed from the values speci- 
fied in the B and D fields of an 
instruction but that are not used to 
address storage. This includes operand 
addresses in LOAD ADDRESS, MONITOR CALL/ 
and the shifting instructions. This 
also includes the addresses in control 
registers 10 and 11 designating the 
starting and ending locations for PER. 

With the exception of INSERT VIRTUAL 
STORAGE KEY and TEST PROTECTION, the 
addresses explicitly designating storage 
keys (operand addresses in SET STORAGE 
KEY EXTENDED, INSERT STORAGE KEY 
EXTENDED, and RESET REFERENCE BIT 
EXTENDED) are real addresses. 
Similarly, the addresses implicitly used 
by the CPU for such sequences as inter- 
ruptions are real addresses. 
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The addresses used by channel programs 
to transfer data and to refer to CCWs or 
IDAUIs are absolute addresses. 

The handling of storage addresses asso- 
ciated with DIAGNOSE is model-dependent. 

The processing of addresses, including 
dynamic address translation and prefix- 
ing, is discussed in the section 
"Address Types" in this chapter. 
Prefixing, when provided, is applied 
after the address has been translated by 
means of the dynamic-address-translation 



facility. For a description of prefix- 
ing, see the section "Prefixing" in this 
chapter. 



HANDLING OF ADDRESSES 



The handling of addresses is summarized 
in the figure "Handling of Addresses." 
This figure lists all addresses that are 
encountered by the program and specifies 
the address type. 



Vi rtual Addresses 

• Address of storage operand for INSERT VIRTUAL STORAGE KEY 

• Operand address in LOAD REAL ADDRESS 

• Addresses of storage operands for MOVE TO PRIMARY and MOVE 
TO SECONDARY 

• Address stored in the word at real location 144 on a program 
interruption for page-translation or segment-translation 
except i on 

Instructi on Addresses 

• Instruction address in PSW 

• Branch address 

• Target of EXECUTE 

• Address stored in the word at real location 152 on a pro- 
gram interruption for PER 

• Address placed in general register by BRANCH AND LINK, 
BRANCH AND SAVE, BRANCH AND SAVE AND SET MODE, and 
PROGRAM CALL 

Logi cal Addresses 

• Addresses of storage operands for instructions not other- 
wise specified 

• Address placed in general register 1 by EDIT AND MARK and 
TRANSLATE AND TEST 

• Addresses in general registers updated by MOVE LONG and 
COMPARE LOGICAL LONG 

• Addresses in general registers updated by COMPARE AND FORM 
CODEWORD and UPDATE TREE 

• Address for TEST PENDING INTERRUPTION when the second- 
operand address i s nonzero 



Real Addresses 



Address of stora 
RESET REFERENCE 
Address of stora 
Page-table origi 
Page-frame real 
Trace-entry addr 
ASN-first-table 
ASN- second- table 
Authori ty- table 
Linkage-table or 
Entry-table orig 
The translated a 



ge key for INSERT STORAGE KEY EXTENDED, 

BIT EXTENDED, and SET STORAGE KEY EXTENDED 

ge operand for TEST BLOCK 

n in INVALIDATE PAGE TABLE ENTRY 

address in page-table entry 

ess in control register 12 

origin in control register 14 

origin in ASN-first-table entry 
origin in ASN-second-table entry 
igin in control register 5 
in in linkage-table entry 
ddress generated by LOAD REAL ADDRESS 



Handling of Addresses (Part 1 of 2) 



Chapter 3. Storage 3-37 



Permanently Assi gned Real Addresses 

• Address of the doubleword into which TEST PENDING INTERRUP- 
TION stores when the second-operand address is zero 

• Addresses of PSWs> interruption codes, and the associated 
information used during interruption 

• Addresses used for machine-check logout and save areas 

Addresses Which Are Unpredi ctablv Real or Absolute 

• Segment-table origin in control registers 1 and 7 

• Page-table origin in segment-table entry 

• Address of segment-table entry or page-table entry provided 
by LOAD REAL ADDRESS 

Absolute Addresses 

• Prefix value 

• Channel-program address in ORB 

• Data address in CCW 

• IDAW address in a CCW specifying indirect data addressing 

• CCW address in a CCW specifying transfer in channel 

• Data address in IDAW 

• Measurement-block origin specified in SET CHANNEL MONITOR 

• Address limit specified in SET ADDRESS LIMIT 

• Addresses used by the store-status-at-address SIGNAL 
PROCESSOR order 

• Failing-storage address stored in the word at real loca- 
tion 248 

• CCW address in SCSW 

Permanently Assi gned Absolute Addresses 

• Addresses used for the store-status function 

• Addresses of PSW and first two CCWs used for initial pro- 
gram loading 

Addresses Not Used to Reference Storage 

• PER starting address in control register 10 

• PER ending address in control register 11 

• Address stored in the word at real location 156 for a 
monitor event 

• Address in shift instructions and other instructions speci- 
fied not to use the address to reference storage 



Handling of Addresses (Part 2 of 2) 



ASSIGNED STORAGE LOCATIONS 0-7 



The figure "Assigned Storage Locations" 
shows the format and extent of the 
assigned locations in storage. The 
locations are used as follows. 8-15 



(Real Address) 

Restart New PSW : The new PSW is 
fetched from locations 0-7 
during a restart interruption. 

(Absolute Address) 



0-7 (Absolute Address) 

Initial-Program-Loading 



The f 

during 

loadin 

ation 

0-7. 

locati 

PSW at 

operat 

also b 

age at 

operat 



i rst 

the 
g (IPL 

are s 

The 
ons a 
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PSW : 
eight bytes read 
i ni tial-program- 
) initial-read oper- 
tored at locations 
contents of these 
re used as the new 
ompletion of the IPL 
These locations may 
for temporary stor- 
nitiation of the IPL 



Initial-Program-Loading CCW1 : 
Bytes 8-15 read during the 
initial-program-loading (IPL) 
initial-read operation ar& 
stored at locations 8-15. The 
contents of these locations are 
ordinarily used as the next CCW 
in an IPL CCW chain after 
completion of the IPL initial- 
read operation. 
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8-15 



(Real Address) 



112-119 (Real Address) 



16-23 



Restart Old PSW: The current 
PSW is stored as the old PSW at 
locations 8-15 during a restart 
interrupti on. 

(Absolute Address) 



Machine-Check New PSW: The new 
PSW is fetched from locations 
112-119 during a machine-check 
interrupti on. 



120-127 (Real Address) 



Ini tial-Program- Loading CCW2 : 
Bytes 16-23 read during the 
initial-program loading (IPL) 
initial-read operation are 
stored at locations 16-23. The 
contents of these locations may 
be used as another CCW in the 
IPL CCW chain to follow IPL 
CCW1. 



24-31 (Real Address) 



External Old PSW : The current 
PSW is stored as the old PSW at 
locations 24-31 during an 
external interruption. 



32-39 (Real Address) 



Supervisor-Call Old PSW : The 
current PSW is stored as the old 
PSW at locations 32-39 during a 
supervisor-call interruption. 



40-47 (Real Address) 



Program Old PSW : The current 
PSW is stored as the old PSW at 
locations 40-47 during a program 
interrupti on. 



48-55 (Real Address) 



Machine-Check Old PSW : The 
current PSW is stored as the old 
PSW at locations 48-55 during a 
machine-check interruption. 



56-63 (Real Address) 



Input/Output Old PSW : The 
current PSW is stored as the old 
PSW at locations 56-63 during an 
I/O interruption. 



88-95 (Real Address) 



External New PSW : The new PSW 
is fetched from locations 88-95 
during an external interruption. 



96-103 (Real Address) 



Supervi sor-Call New PSW : The 
new PSW i s fetched from 
locations 96-103 during a 
supervisor-call interruption. 



104-111 (Real Address) 



Program New PSW : The new PSW is 
fetched from locations 104-111 
during a program interruption. 



Input/Output New 
PSW is fetched 
120-127 during 
rupti on. 



128-131 (Real Address) 



PSW : The new 
from locations 
an I/O intei — 



External-Interrupt i on Parameter : 
During an external interruption 



due to service signal, 
parameter associated with 
interruption is stored 
locations 128-131. 



the 

the 

at 



132-133 (Real Address) 



CPU Address : During an external 
interruption due to malfunction 
alert, emergency signal, or 
external call, the CPU address 
associated with the source of 
the interruption is stored at 
locations 132-133. For all 
other external-interruption 
conditions, zeros are stored at 
locations 132-133. 



134-135 (Real Address) 



External-Interrupti on Code : 
During an external interruption, 
the interruption code is stored 
at locations 134-135. 



136-139 (Real Address) 



Supervi sor-Call-Interrupti on 
Identi f i cati on: 



supe 

the 

stor 

of 1 

rupt 

loca 
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loca 



During a 

rvisoi — call interruption, 

instruction-length code is 

ed in bit positions 5 and 6 

ocation 137, and the inter- 



ion code is stored 
tions 138-139. Zeros 
ed at location 136 and 
remaining bit positions 
tion 137. 
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140-143 (Real Address) 



Program-Interrupt i on Identifi- 
cation : During a program intei — 
ruption, the instruction-length 
code is stored in bit positions 
5 and 6 of location 141, and the 
interruption code is stored at 
locations 142-143. Zeros are 
stored at location 140 and in 
the remaining bit positions of 
location 141. 
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144-1*7 (Real Address) 



152-155 (Real Address) 



Translati on-Excepti on Identif i- 
cati on : During a program inter- 
ruption due to a segment- 
translation exception or a 
page-translation exception, the 
segment-index and page-index 
portion of the virtual address 
causing the exception is stored 
at locations 144-147. This 
address is sometimes referred to 
as the translation-exception 
address. The rightmost 12 bits 
of the address are unpre- 
dictable. Bit of location 144 
is set to zero if the trans- 
lation was relative to the 
primary segment table designated 
by control register 1, or it is 
set to one if the translation 
was relative to the secondary 
segment table designated by 
control register 7. 

During a program interruption 
due to an AFX-translati on, ASX- 
translation, primary-authority, 
or secondary-authority excep- 
tion, the ASN being translated 
is stored at locations 146-147. 
Zeros are stored at locations 
144-145. 



During a prog 
for a space-sw 
old PASN, which 
of control regi 
execution of a 
PROGRAM CALL or 
i nstructi on, 
locations 146 
space-swi tch-ev 
is stored in bi 
zeros are stor 
tions 1-15 of 1 



ram interruption 
itch event, the 

is in bits 16-31 

ster 4 before the 

space-swi tchi ng 

PROGRAM TRANSFER 
i s stored at 
-147. The old 
ent-control bit 
t position 0, and 
ed in bit posi- 
ocations 144-145. 



During a program interruption 
due to an LX-translati on or EX- 
translation exception, the PC 
number is stored in bit posi- 
tions 12-31 of the word at 
locations 144-147. Bits 0-11 
are set to zeros. 



PER Address : During a program 
interruption due to a program 
event, the PER address is stored 
at locations 152-155. Bit of 
location 152 is set to zero. 



156-159 (Real Address) 



Monitor Code: During a program 
interruption due to a monitor 
event, the monitor code is 
stored at locations 156-159. 



184-187 (Real Address) 



Subsystem-Identi f i cati on Word : 
During an I/O interruption, the 
subsystem-identification word is 
stored at locations 184-187. 

188-191 (Real Address) 

I/Q-Interrupti on Parameter : 
During an I/O interruption, the 
interruption parameter from the 
associated subchannel is stored 
at locations 188-191. 

216-223 (Absolute Address) 

Store-Status CPU-Timer Save 
Area : During the execution of 
the store-status operation, the 
contents of the CPU timer are 
stored at locations 216-223. 

216-223 (Real Address) 

Machi ne-Check CPU-Timer Save 
Area : During a machine-check 
interruption, the contents of 
the CPU timer are stored at 
locations 216-223. 

224-231 (Absolute Address) 

Store-Status Clock-Comparator 
Save Area : During the execution 
of the store-status operation, 
the contents of the clock compa- 
rator are stored at locations 
224-231. 



148-149 (Real Address) 



224-231 (Real Address) 



Moni tor-Class Number : During a 
program interruption due to a 
monitor event, the monitor-class 
number is stored at location 
149, and zeros are stored at 
location 148. 



150-151 (Real Address) 



PER Code : During a program 
interruption due to a PER event, 
the PER code is stored in bit 
positions 0-3 of location 150. 
Zeros are stored in bit posi- 
tions 4-7 of location 150 and 
bit positions 0-7 of location 
151. 



Machi ne-Check Clock-Comparator 
Save Area : During a machine- 
check interruption, the contents 
of the clock comparator are 
stored at locations 224-231. 



232-239 (Real Address) 



Machi ne-Check-Interrupt i on Code : 
During a machine-check interrup- 
tion, the machine-check-inter- 
ruption code is stored at 
locations 232-239. 
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244-247 (Real Address) 



352-383 (Real Address) 



External -Damage Code : During a 
machine-check interruption due 
to certain external-damage 
conditions* depending on the 
model, an external-damage code 
may be stored at locations 
244-247. 

248-251 (Real Address) 

Fai li ng-Storage Address ? During 
a machine-check interruption, a 
failing-storage address may be 
stored at locations 248-251. 
Bit of location 248 is set to 
zero. 

256-263 (Absolute Address) 

Store-Status PSW Save Area ? 
During the execution of the 
store-status operation, the 
contents of the current PSW are 
stored at locations 256-263. 

256-271 (Real Address) 

Fixed-Logout Area : Depending on 
the model, logout information 
may be stored at locations 
256-271 during a machine-check 
interrupt! on. 



Machi ne-Check Floating-Point- 
Regi ster Save Area : During a 
machine-check interruption, the 
contents of the floating-point 
registers are stored at 
locations 352-383. 

384-447 (Absolute Address) 

Store-Status General-Regj ster 
Save Area : During the execution 
of the store-status operation, 
the contents of the general 
registers are stored at 
locations 384-447. 

384-447 (Real Address) 

Machi ne-Check General-Regi ster 
Save Area : During a machine- 
check interruption, the contents 
of the general registers are 
stored at locations 384-447. 

448-511 (Absolute Address) 

Store-Status Control-Regi ster 
Save Area : During the execution 
of the store-status operation, 
the contents of the control 
registers are stored at 
locations 448-511. 



264-267 (Absolute Address) 



448-511 (Real Address) 



Store-Status Prefix Save Area : 
During the execution of the 
store-status operation, the 
contents of the prefix register 
are stored at locations 264-267. 



Machine-Check Control-Regi ster 
Save Area : During a machine- 
check interruption, the contents 
of the control registers are 
stored at locations 448-511. 



352-383 (Absolute Address) 

Store-Status Floati ng-Poi nt- 
Regi ster Save Area : During the 
execution of the store-status 
operation, the contents of the 
floating-point registers are 
stored at locations 352-383. 
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Hex 


Dec 










Ini tial-Program-Loading PSW; or Restart New PSW 


4 


4 




8 


8 


Initial-Program-Loading CCWlj or Restart Old PSW 


C 


12 




10 


16 


Initial-Program Loading CCW2 


1* 


20 




18 


24 


External Old PSW 


1C 


28 




20 


32 


Supervisor-Call Old PSW 


24 


36 




28 


40 


Program Old PSW 


2C 


44 




30 


48 


Machine-Check Old PSW 


34 


52 




38 


56 


Input/Output Old PSW 


3C 


60 




40 


64 




44 


68 




48 


72 




4C 


76 




50 


80 




54 


84 




58 


88 


External New PSW 


5C 


92 




60 


96 


Supervisor-Call New PSW 


64 


100 




68 


104 


Program New PSW 


6C 


108 




70 


112 


Machine-Check New PSW 


74 


116 




78 


120 


Input/Output New PSW 


7C 


124 
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Hex Dec 
80 128 



External-Interruption Parameter 



84 132 



CPU Address 



External-Interruption Code 



88 136 



0000000000000 



ILC 



SVC-Interruption Code 



8C 140 



0000000000000 ILC Program-Interruption Code 



90 144 



Translati on-Except i on I dent if i cat i on 



94 148 



Monitoi — Class Number 



PER Cde 000000000000 



98 152 



PER Address 



9C 156 



Monitor Code 



A0 


160 


A4 


164 


A8 


168 


AC 


172 


B0 


176 


B4 


180 



B8 184 



Subsystem-Identification Word 



BC 188 



I/O-Interrupti on Parameter 



| 



CO 
C4 
C8 
CC 
DO 
D4 



192 
196 
200 
204 
208 
212 



D8 
DC 



216 
220 



Store-Status CPU-Timer Save Area; or Machine-Check CPU-Timer 
Save Area 



E0 
E4 



224 
228 



Store-Status Clock-Comparator Save Area; or Machine-Check 
Clock-Comparator Save Area 



E8 
EC 



232 
236 



Machine-Check Interruption Code 



F0 240 



F4 244 



External-Damage Code 



F8 248 



Failing-Storage Address 



FC 252 



Assigned Storage Locations (Part 2 of 3) 
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Hex 


Dec 






100 
104 


256 
260 


Store-Status 


PSW Save Area; or Fixed-Logout Area (Part 1) 


108 


264 


Store-Status 


Prefix Save Area; or Fixed-Logout Area (Part 2) 


IOC 


268 


Fixed-Logout 


Area (Part 3) 


110 


272 









/ 


/ 


158 


344 




15C 


348 




160 
164 


352 
356 


Store-Status Floating-Point-Register Save Area; or Machine- 
Check Floating-Point-Register Save Area 


168 


360 




16C 


364 




170 


368 




174 


372 




178 


376 




17C 


380 




180 
184 


384 
388 


Store-Status General-Register Save Area; or Machine-Check 
General-Register Save Area 


188 


392 




18C 


396 







> 


' / 


1B4 


436 




1B8 


440 




1BC 


444 




1C0 
1C4 


448 
452 


Store-Status Control-Register Save Area; or Machine-Check 
Control-Register Save Area 


1C8 


456 




ICC 


460 







/ 


' / 


1F4 


500 




1F8 


504 




1FC 


508 
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This chapter describes in detail the 

facilities for controlling* measuring, 

and recording the operation of one or 
more CPUs. 



STOPPED, OPERATING, 
STATES 



LOAD, AND CHECK-STOP 



The stopped, operating, load, and 
check-stop states are four mutually 
exclusive states of the CPU. When the 
CPU is in the stopped state, 
instructions and interruptions, other 
than the restart interruption, are not 
executed. In the operating state, the 
CPU executes instructions and takes 
interruptions, subject to the control of 
the program-status word (PSW) and 
control registers, and in the manner 
specified by the setting of the 
operator-facility rate control. The CPU 
is in the load state during the 
initial-program-loading operation. The 
CPU enters the check-stop state only as 
the result of machine malfunctions. 

A change between these four CPU states 
can be effected by use of the operator 
facilities or by acceptance of certain 
SIGNAL PROCESSOR orders addressed to 
that CPU. The states are not controlled 
or identified by bits in the PSW. The 
stopped, load, and check-stop states are 
indicated to the operator by means of 
the manual indicator, load indicator, 
and check-stop indicator, respectively. 
These three indicators are off when the 
CPU is in the operating state. 

The CPU timer is updated when the CPU is 
in the operating state or the load 
state. The TOD clock is not affected by 
the state of any CPU. 



STOPPED STATE 



stopped state occurs at the end of the 
current unit of operation. When the 
wait-state bit of the PSW is one, the 
transition takes place immediately, 
provided no interruptions are pending 
for which the CPU is enabled. In the 
case of interruptible instructions, the 
amount of data processed in a unit of 
operation depends on the particular 
instruction and may depend on the model. 



Before enterin 
means of the st 
allowed interr 
the CPU is stil 
They cause the 
the new PSW t 
stopped state i 
is in the sto 
conditions rema 



g the stopped state by 
op function, all pending 
uptions are taken while 
1 in the operating state, 
old PSW to be stored and 
o be fetched before the 
s entered. While the CPU 
pped state, interruption 
in pending. 



The CPU is also placed in the stopped 
state when: 

• The CPU reset is completed. Howev- 
er, when the reset operation is 
performed as part of initial 
program loading for this CPU, then 
the CPU is placed in the load state 
and does not necessarily enter the 
stopped state. 

• An address comparison indicates 
equality and stopping on the match 
is specified. 

The execution of resets is described in 
the section "Resets" in this chapter, 
and address comparison is described in 
the section "Address-Compare Controls" 
in Chapter 12, "Operator Facilities." 

If the CPU is in the stopped state when 
an INVALIDATE PAGE TABLE ENTRY instruc- 
tion is executed on another CPU in the 
configuration, the invalidation may be 
performed immediately or may be delayed 
until the CPU leaves the stopped state. 



The CPU changes from the operating state 
to the stopped state by means of the 
stop function. The stop function is 
performed when: 

• The stop key is activated while the 
CPU is in the operating state. 

• The CPU accepts a stop or stop- 
and-store-status order specified by 
a SIGNAL PROCESSOR instruction 
addressed to this CPU while it is 
in the operating state. 

• The CPU has finished the execution 
of a unit of operation initiated by 
performing the start function with 
the rate control set to the 
instruction-step position. 

When the stop function is performed, the 
transition from the operating to the 



OPERATING STATE 



The CPU changes from the stopped state 
to the operating state by means of the 
start function or when a restart inter- 
ruption (see Chapter 6) occurs. 

The start function is performed if the 
CPU is in the stopped state and (1) the 
start key associated with that CPU is 
activated or (2) that CPU accepts the 
start order specified by a SIGNAL 
PROCESSOR instruction addressed to that 
CPU. The effect of performing the start 
function is unpredictable when the 
stopped state has been entered by means 
of a reset. 

When the rate control is set to the 
process position and the start function 
is performed, the CPU starts operating 
at normal speed. When the rate control 
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persistent interruption condition, 
such as one due to the CPU timer. 

3. Pending I/O operations may be 
initiated, and active I/O oper- 
ations continue to suspension or 
completion, after the CPU enters 
the stopped state. The i ntei — 
ruption conditions due to 
suspension or completion of I/O 
operations remain pending when the 
CPU is in the stopped state. 



PROGRAM-STATUS WORD 



LOAD STATE 



The CPU enters the load 
load-normal or load-clea 
vated. (See the sec 
Program Loading™ in this 
also the section "Initia 
ing" in Chapter 17, "I/O 
tions.") If the initial- 
operation is completed su 
CPU "changes from the loa 
operating state, provi 
control is set to the pr 
if the rate control i 
instruction-step positi 
changes from the load 
stopped state. 



CHECK-STOP STATE 



The check-stop state, which the CPU 
enters on certain types of machine 
malfunction, is described in Chapter 11, 
"Machine-Check Handling." The CPU 
leaves the check-stop state when CPU 
reset is performed. 
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The current program-status word (PSW) in 
the CPU contains information required 
for the execution of the currently 



active program. The PSW is 
length and includes the 
address, condition code, 
control fields. In general, 
control instruction 
hold and indicate 



64 bits in 

instructi on 

and other 

the PSW is 

sequenci ng 

much of the 



used to 
and to 

status of the CPU in relation to the 
program currently being executed. Addi- 
tional control and status information is 
contained in control registers and 
permanently assigned storage locations. 

The status of the CPU can be changed by 
loading a new PSW or part of a PSW. 

Control is switched during an inter- 
ruption of the CPU by storing the 
current PSW, so as to preserve the 
status of the CPU, and then loading a 
new PSW. 



Programming Notes 



Execution of LOAD PSW, 
conclusion of the 
loading sequence, introd 
The instruction address 
sequential instruction 
replaced by successful 
instructions are provide 
on a portion of the P 
"Operations on PSW Fie 
these instructions. 



r the successful 
ini tial-program- 
uces a new PSW. 
i s updated by 
execution and 
branches. Other 
d which operate 
SW. The figure 
Ids" summarizes 



Except for the relationship between 
execution time and real time, the 
execution of a program is not 
affected by stopping the CPU. 

When, because of a machine malfunc- 
tion, the CPU is unable to end the 
execution of an instruction, the 
stop function is ineffective, and a 
reset function has to be invoked 
instead. A similar situation 
occurs when an unending string of 
interruptions results from a PSW 
with a PSW-format error of the type 
that is recognized early, or from a 



A new or modified PSW becomes active 
(that is, the information introduced 
into the current PSW assumes control 
over the CPU) when the interruption or 
the execution of an instruction that 
changes the PSW is completed. The 
interruption for PER associated with an 
instruction that changes the PSW occurs 
under control of the PER mask that is 
effective at the beginning of the opera- 
ti on. 

Bits 0-7 of the PSW are collectively 
referred to as the system mask. 
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Instruction 



System Mask 

(PSW Bits 

0-7) 



Saved 



Set 



PSW Key 

(PSW Bits 

8-11) 



Saved 



Set 



Problem 
State 
(PSW 

Bit 15) 



Saved 



Set 



Address- 
Space 

Control 
(PSW 

Bit 16) 



Saved 



Set 



Condition 
Code and 

Program 

Mask 

(PSW Bits 

18-23) 



Saved 



Set 



Addressing 

Mode 

(PSW 

Bit 32) 



Saved 



Set 



BRANCH AND LINK 
BRANCH AND SAVE 
BRANCH AND SAVE AND SET 

MODE 
BRANCH AND SET MODE 
INSERT PROGRAM MASK 
INSERT PSW KEY 
INSERT ADDRESS SPACE 

CONTROL 
PROGRAM CALL 
PROGRAM TRANSFER 
SET ADDRESS SPACE CONTROL 
SET PROGRAM MASK 
SET PSW KEY FROM ADDRESS 
SET SYSTEM MASK 
STORE THEN AND SYSTEM MASK 
STORE THEN OR SYSTEM MASK 



No 
No 
No 

No 
No 
No 
No 

No 

No 

No 

No 

No 

No 

Yes 

Yes 



No 
No 
No 

No 
No 
No 
No 

No 

No 

No 

No 

No 

Yes 

ANDs 

ORs 



No 
No 
No 

No 
No 
Yes 
No 

No 
No 
No 
No 
No 
No 
No 
No 



No 
No 
No 

No 
No 
No 
No 

No 

No 

No 

No 

Yes 

No 

No 

No 



No 
No 
No 

No 
No 
No 
No 

Yes 

No 

No 

No 

No 

No 

No 

No 



No 
No 
No 

No 
No 
No 
No 

Yes 

Yes 2 

No 

No 

No 

No 

No 

No 



No 
No 
No 

No 
No 
No 
Yes 

No 
No 
No 
No 
No 
No 
No 
No 



No 
No 
No 

No 
No 
No 
No 

No 

No 

Yes 

No 

No 

No 

No 

No 



AM 
No 
No 

No 
Yes 
No 
No 

No 
No 
No 
No 
No 
No 
No 
No 



No 
No 
No 

No 
No 
No 
No 

No 

No 

No 

Yes 

No 

No 

No 

No 



AM 

Yes 

Yes 

Yes 1 
No 
No 
No 

Yes 

No 

No 

No 

No 

No 

No 

No 



No 
No 
Yes 1 

Yes* 
No 
No 
No 

Yes 

Yes 

No 

No 

No 

No 

No 

No 



Explanation : 



i 

2 

AM 



ANDs 



ORs 



The action takes place only if the associated R field in the instruction is nonzero. 

Cannot be changed from one to zero. 

The action depends on the addressing mode* bit 32 of the current PSW. In the 24-bit 
addressing mode, the condition code and program mask are saved in the leftmost byte of 
the general register. In the 31-bit addressing mode, the addressing mode, along with 
bits 1-7 of the 31-bit address, replace the leftmost byte of the register. 

The logical AND of the immediate field in the instruction and the current system mask 
replaces the current system mask. 

The logical OR of the immediate field in the instruction and the current system mask 
replaces the current system mask. 



Operations on PSW Fields 



Programming Note 



A summary of the operations which save 
or set the problem state, addressing 
mode/ and instruction address is 
contained in the section "Subroutine 
Linkage" in Chapter 5, "Program 

Executi on." 
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PROGRAM-STATUS-WORD FORMAT 






R 





T 


I 



E 
X 


Key 


1 


M 


Ul 


P 


S 





c c 


Prog 
Mask 





5 8 12 16 18 20 24 31 


A 


Instruction Address 



32 

PSW Format 



63 



> 



The following is a summary of the func- 
tions of the PSW fields. (See the 
figure "PSW Format.") 

PER Mask (R) : Pit 1 controls whether 
the CPU is enabled for interruptions 
associated with program-event recording 
(PER). When the bit is zero, no PER 
event can cause an interruption. When 
the bit is one, interruptions are 
permitted, subject to the PER-event-mask 
bits in control register 9. 

DAT Mode (T): Bit 5 controls whether 
implicit dynamic address translation of 
logical and instruction addresses used 
to access storage takes place. When the 
bit is zero, DAT is off, and logical and 
instruction addresses are treated as 
real addresses. When the bit is one, 
DAT is on, and the dynamic-address- 
translation mechanism is invoked. 



I/O Mask (10): Bit 6 
the CPU is enabled fo 
tions. When the bit is 
terruption cannot occur 
is one, I/O interruption 
the I/O-i nterrupt i on su 
in control register 6. 
interruption subclass-ma 
an I/O interruption 
interruption subclass ca 
the I/O-i nterrupti on su 
is one, an I/O interr 
I/O-i nterrupti on subclas 



controls whether 
r I/O interrup- 
zero, an I/O i n- 

When the bit 
s are subject to 
bclass-mask bits 

When an 1/0- 
sk bit is zero, 
for that 1/0- 
nnot occur; when 
bclass-mask bit 
uption for that 
s can occur. 



External Mask (EX): Bit 7 controls 
whether the CPU is enabled for intei — 
ruption by conditions included in the 
external class. When the bit is zero, 
an external interruption cannot occur. 
When the bit is one, an external intei — 
ruption is subject to the corresponding 
external subclass-mask bits in control 
register 0; when the subclass-mask bit 
is zero, conditions associated with the 
subclass cannot cause an interruption; 
when the subclass-mask bit is one, an 
interruption in that subclass can occur. 

PSW Key : Bits 8-11 form the access key 
for storage references by the CPU. If 
the reference is subject to key- 



controlled protection, the PSW key is 
matched with a storage key when informa- 
tion is stored or when information is 
fetched from a location that is 
protected against fetching. However, 
for accesses to the second operand of 
MOVE TO PRIMARY and MOVE WITH KEY, the 
third operand is used instead of the PSW 
key. The third operand is also used 
instead of the PSW key for accesses to 
the first operand of MOVE TO SECONDARY. 



Machi ne-Check Mask (M 
whether the CPU is 
ruption by machine 
When the bit is zer 
interruption cannot o 
is one, machine-check 
to system damage 
processing damage a 
interruptions due t 
check-subclass condit 
the subclass-mask bit 
ter 14. 



): Bit 13 controls 
enabled for intei — 

check conditions. 

o, a machine-check 

ccur. When the bit 

interruptions due 

and instruction- 
re permitted, but 
o other machine- 
ions are subject to 
s in control regis- 



Wait State (W): When bit 14 is one, the 
CPU is waiting; that is, no instructions 
are processed by the CPU, but inter- 
ruptions may take place. When bit 14 is 
zero, instruction fetching and execution 
occur in the normal manner. The wait 
indicator is on when the bit is one. 

Problem State ( P) : When bit 15 is one, 
the CPU is in the problem state. When 
bit 15 is zero, the CPU is in the supei — 
visor state. In the supervisor state, 
all instructions are valid. In the 
problem state, only those instructions 
are valid that provide meaningful infor- 
mation to the problem program and that 
cannot affect system integrity; such 
instructions are called unprivileged 
instructions. The instructions that are 
never valid in the problem state are 
called privileged instructions. When a 
CPU in the problem state attempts to 
execute a privileged instruction, a 
privileged-operation exception is recog- 
nized. Another group of instructions, 
called semipri vi leged instruction*, are 
executei by a CPU in the problem state 
only if specific authority tests are? 
metf otherwise, a privileged-operation 
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exception or a special-operation excep- 
tion is recognized. 

Address-Space Control ( S) : Bit 16, in 
conjunction with PSW bit 5/ controls the 
translation mode. See the section 
"Translation Modes™ under "Translation 
Control" in Chapter 3, "Storage." 



Condition Code (CO 
the two bits of the 
condition code is se 
depending on the 
executing certain 
arithmetic and logi 
well as some other 
condition code. The 
ON CONDITION can sp 
of the condition-cod 
rion for branching. 
C summarizes the co 
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Bits 18 and 19 are 
condition code. The 
t to 0, 1, 2, or 3, 
result obtained in 
instructions. Most 
cal operations, as 
operations, set the 
instruction BRANCH 
ecify any selection 
e values as a crite- 
A table in Appendix 
ndition-code values 
or all instructions 
ion code of the PSW. 



Program Mask: Bits 20-23 are the four 
program-mask bits. Each bit is associ- 
ated with a program exception, as 
follows: 



Program- 
Mask Bit 


Program Exception 


20 
21 
22 
23 


Fixed-point overflow 
Decimal overflow 
Exponent underflow 
Si gni f i cance 



When the mask bit is one, the exception 
results in an interruption. When the 
mask bit is zero, no interruption 
occurs. The setting of the exponent- 
underflow-mask bit or the significance- 
mask bit also determines the manner in 
which the operation is completed when 
the corresponding exception occurs. 

Addressi ng Mode (A): Bit 32 controls 
the size of effective addresses and 
effective-address generation. When the 
bit is zero, 24-bit addressing is speci- 
fied. When the bit is one, 31-bit 
addressing is specified. The addressing 
mode does not control the size of PER 
addresses or of addresses used to access 
DAT, ASN, linkage, entry, and trace 
tables. See the section "Address Genei — 
ation" in Chapter 5, "Program 
Execution," and the section "Address 
Size and Wraparound" in Chapter 3, "Sto- 
rage." 

Instructi on Address : Bits 33-63 form 
the instruction address. This address 
designates the location of the leftmost 
byte of the next instruction to be 
executed, unless the CPU is in the wait 
state (bit 14 of the PSW is onc>) . 

Bit positions 0, 2-4, 17, and 24-31 are 
unassigned and must contain zeros. A 
specification exception is recognized 
when these bit positions do not contain 



zeros. When bit 32 of the PSW specifies 
the 24-bit addressing mode, bits 33-39 
of the instruction address must be 
zeros; otherwise, a specification excep- 
tion is recognized. A specification 
exception is also recognized when bit 
position 12 does not contain a one. 



CONTROL REGISTERS 



The control registers provide for main- 
taining and manipulating control infor- 
mation outside the PSW. There are 
sixteen 32-bit control registers. 

All control-register bit positions in 
all 16 control registers are installed, 
regardless of whether the bit position 
is assigned to a facility. One or more 
specific bit positions in control regis- 
ters are assigned to each facility 
requiring such register space. 



The LOAD CONTROL instruc 
contrbl-regi Iter posi t i on 
registers designated^ by 
to be loaded from 
instructions LOAD ADDRESS 
TERS, SET SECONDARY ASN, 
and PROGRAM TRANSFER prov 
functions to place in 
certain control-register 



ti on causes all 
s f within those 
the instruction 
storage.? 4 The 
SPACE PARAME- 
PROGRAM CALL, 
i de specialized 
formation into 
positions. 



Information loaded into the control 
registers becomes active (that is, 
assumes control over the system) at the 
completion of the instruction causing 
the information to be loaded. 

At the time the registers are loaded, 
the information is not checked for 
exceptions, such as invalid 
translation-format code or an address 
designating an unavailable or a 
protected location. The validity of the 
information is checked and the 
exceptions, if any, are indicated at the 
time the information is used. 

The STfR€ CONTROL instruction causes all 
control-register positions, within those 
registers designated by the instruction, 
to be placed in storage. The 
instructions EXTRACT PRIMARY ASN, 
EXTRACT SECONDARY ASN, and PROGRAM CALL 
provide specialized functions to obtain 
information from certain control- 
register positions. 



Only the genera 
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control-register positions not listed in 
the figure are initialized to zero. 



Programming Notes 



1. The detailed definition of a 
particular control-register bit 
position can be located by refer- 



ring to the entry "control-register 
assignment" in the Index. 

To ensure that existing programs 
operate correctly if and when new 
facilities using additional 
control-register positions are 
installed, the program should load 
zeros in unassigned control- 
register positions. 



Ctrl 
Reg 


Bits 


Name of Field 


Associated with 


Ini tial 
Value 






















1 

2 

3 

4 

5 

6 
8-12 
14 
16 
17 
18 
19 
20 
21 
22 
24 
25 
26 


SSM-suppressi on control 
TOD-clock-sync control 
Low-address-protection control 
Extraction-authority control 
Secondary-space control 
Fetch-protection override 
Translation format 
Vector control 1 

Malfunction-alert subclass mask 
Emergency-signal subclass mask 
External-call subclass mask 
TOD-clock sync-check subclass mask 
Clock-comparator subclass mask 
CPU-timer subclass mask 
Service-signal subclass mask 
Unused 2 

Interrupt-key subclass mask 
Unused 2 


SET SYSTEM MASK 

TOD clock 

Low-address protection 

Dual-address-space control 

Dual-address-space control 

Key-controlled protection 

Dynamic address translation 

Vector operations 

Interrupt i ons 

Interrupti ons 

Interrupti ons 

Interrupti ons 

Clock comparator 

CPU timer 

Service signal 

External interruptions 

















1 
1 
1 


1 
1 
1 



1-19 
25-31 


Space-switch-event control 
Primary segment-table origin 
Primary segment-table length 


Dual-address-space control 
Dynamic address translation 
Dynamic address translation 







3 
3 


0-15 
16-31 


PSW-key mask 
Secondary ASN 


Dual-address-space control 
Dual-address-space control 






4 
4 


0-15 
16-31 


Authorization index 
Primary ASN 


Dual-address-space control 
Dual-address-space control 






5 
5 
5 



1-24 
25-31 


Subsystem-linkage control 
Linkage-table origin 
Linkage-table length 


Dual-address-space control 
PC-number translation 
PC-number translation 







6 


0-7 


I/O- interrupti on subclass mask 


I/O 





7 
7 


1-19 
25-31 


Secondary segment-table origin 
Secondary segment-table length 


Dynamic address translation 
Dynamic address translation 






8 


16-31 


Monitor masks 


MONITOR CALL 





9 
9 
9 
9 
9 



1 
2 
3 
16-31 


Successful-branching-event mask 
Instruction-fetching-event mask 
Storage-alteration-event mask 
GR-alterati on-event mask 
PER general-register masks 


Program-event recording 
Program-event recording 
Program-event recording 
Program-event recording 
Program-event recording 









10 


1-31 


PER starting address 


Program-event recording 





11 


1-31 


PER ending address 


Program-event recording 






Assignment of Control-Register Fields (Part 1 of 2) 



> 
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Ctrl 
Reg 



Bits 



Name of Field 



Associated with 



Ini tial 
Value 



12 
12 
12 
12 




1-29 
30 
31 



Branch-trace control 
Trace-entry address 
ASN-trace control 
Explicit-trace control 



Traci ng 
Traci ng 
Traci ng 
Traci ng 



1* 
14 
14 

14 
14 
14 
14 
14 
14 




1 
3 

4 
5 
6 
7 
12 
13-31 



Unused 2 
Unused 2 
Channel-report-pending subclass 

mask 
Recovery subclass mask 
Degradation subclass mask 
External-damage subclass mask 
Warning subclass mask 
ASN-translat ion control 
ASN-f i rst-table origin 



I/O machine-check handling 

Machine-check handling 
Machine-check handling 
Machine-check handling 
Machine-check handling 
ASN translation 
ASN translation 



Explanati on ? 



The fields not listed are unassigned. 
control-register positions is zero. 



The initial value for all unlisted 



1 Bit 14 of control register 0, the vector-control bit, is described in the 
publication IBM Svstein/370 Vector Operations , SA22-7125. 

2 This bit is not used but is initialized to one for consistency with the 
System/370 definition. 



Assignment of Control-Register Fields (Part 2 of 2) 



TRACING 



Tracing assists in the 
system problems by pro 
record in storage of si 
Tracing consists of 
controllable functiorf 
entries to be made in 
branch tracing, ASN tra 
it traci n#. Branch 
tracing together are 
implicit tracing. 



determination of 
viding an ongoing 
gnificant events, 
three separately^ 
fc which cause 
a trace table: 
cin# and expl i ea- 
tracing and ASN 

referred to as 



When branch tracing is cfn, an entry i% 
made in the trace table for each 
execution of certain branch instructions 
when they cause branching. The branch 
address is placed in the trace entry. 
The trace entry also indicates the 
addressing mode in effect after branch- 
ing. The branch instructions that are 
traced are: 

BRANCH AND LINK CBAOR only) when 
the R a field is not zero 

BRANCH AND SAVE ?tASR*&only) when 
the R 2 field is not zero. 

BRANCH AND SAVE AND SET MO%E when 
the R 2 field is not zero 

When ASN traCinig is on, an entry is made 
in the trace table for each execution of 
the following instructions: 

tWblftldM CAUL 

Program transfer 

SET SECONDARY m N 



When explicit tracirtg is on, execution 
of TRAC^causes an entry to be made in 
the trace table. This entry includes 
bits 16-63 from the TOD clock, the 
second operand of the TRACE instruction, 
and the contents of a range of general 
regi sters. 



CONTROL-REGISTER ALLOCATION 



The information to control tracing is 
contained in control register 12 and has 
the following format: 



Trace-Entry Address 



A E 



30 31 



Branch-Trace-Control Bit (B): Bit of 
control register 12 controls whether 
branch tracing is turned on or off. If 
the bit is zero, branch tracing is off; 
if the bit is one, branch tracing is on. 

Trace-Entry Address : Bits 1-29 of 
control register 12, with two zero bits 
appended on the right, form the rea \ 
address of the next trace entry to be 1 
madei 

ASN-Trace-Control Bit (A): Bit 30 of 
control register 12 controls whether ASN 



if 
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tracing is turned on or off. If the bit 
is zero, ASN tracing is off; if the bit 
is one, ASN tracing is on. 

Expl i ci t-Trace^Controi Bit ( E) : Bit 31 
of control register 12 controls whether 
explicit tracing is turned on or off. 
If the bit is zeros, explicit tracing \§ 
off 1 ! which causes the TRACE instruction 
to be executed as a no-operati o%; if the 
bit is one, the execution of the TRACE 
instruction creates an entry in the 



trace table, except that no entry is 
made when bit of the second operand of 
the TRACE instruction is one. 



TRACE ENTRIES 



Trace entries are of six types, as shown 
in the figure "Trace-Entry Formats." 



31-Bit Branch 



Branch Address 



24-Bit Branch 



31 



00000000 


Branch Address 



31 



SET SECONDARY ASN 



00010000 


00000000 


New SASN 



16 



31 



PROGRAM CALL 



00100001 



PSW 
Key 



PC Number 



GR 14 After 



12 



32 



63 



PROGRAM TRANSFER 



00110001 


PSW 
Key 


0000 


New PASN 


R 2 Before 



8 12 16 



32 



63 



TRACE 



0111 


N 


00000000 


TOD-Clock Bits 16-63 



16 



63 



64 



TRACE Operand 



(R,) - (R 3 ) 

/ 



96 



95 + 32CN+1) 



| 



Trace-Entry Formats 
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Branch Address : The branch address is 
the address of the next instruction to 
be executed when the branch is taken. 
When the 31-bit addressing mode is in 
effect after branching* bit positions 
1-31 of the trace entry for a branch 
instruction contain the branch address. 
When the 24-bit addressing mode is in 
effect after branching* bit positions 
8-31 contain the branch address. 



New SASN : Bit positions 
trace entry for SET 
contain the ASN value 
control register 3 by the 



16-31 of the 
SECONDARY ASN 
loaded into 
instructi on. 



PSW Key : Bit positions 8-11 of the 
trace entries made on execution of 
PROGRAM CALL and PROGRAM TRANSFER 
contain the PSW key from the current 
PSW. 

PC Number : Bit positions 12-31 of the 
trace entry made on execution of PROGRAM 
CALL contain the value of the rightmost 
20 bits of the second-operand address. 

GR14 After : Bit positions 32-63 of the 
trace entry made on execution of PROGRAM 
CALL contain the information which is 
placed in general register 14: the 
addressing bit, the return address* and 
the problem-state bit. 

New PASN : Bit positions 16-31 of the 
trace entry made on execution of PROGRAM 
TRANSFER contain the new PASN (which may 
be zero) specified by the instruction. 



R2 Before : Bit posit 
trace entry made on ex 
TRANSFER contain the 
general register desi 
field of the instructi 
the general regi ster 
R2 field replace bits 
Bit 31 of the same 
replaces the problem- 
PSW. 



ions 32-63 of the 
ecution of PROGRAM 

contents of the 
gnated by the R a 
on. Bits 0-30 of 
designated by the 

32-62 of the PSW. 

general register 
state bit of the 



Number of Regi sters (N): Bits 4-7 of 
the trace entry for TRACE contain a 
value which is one less than the number 
of general registers which have been 
provided in the trace entry. The value 
of N ranges from zero* meaning the 
contents of one general register are 
provided in the trace entry* to 15, 
meaning the contents of all 16 general 
registers are provided. 

TOD-Clock Bits 16-63 : Bits 16-63 of the 
trace entry for TRACE are obtained from 
bit positions 16-63 of the TOD clock* as 
would be provided by a STORE CLOCK 
instruction executed at the time the 
TRACE instruction was executed. 

TRACE Operand : Bits 64-95 of the trace 
entry for TRACE contain a copy of the 32 
bits of the second operand of the TRACE 
instruction for which the entry is made. 



CR1)-CR3): The fou 
ing with bit 96 of 
TRACE contain the c 
al registers whose 
the Ri and R 3 f 
instruction. The g 
stored in ascendin 
numbers* starting w 
Ri and continuing 
general register R 3 
ter following gen 



Programmi ng Note 



r-byte fields start- 
the trace entry for 
ontents of the gener- 
range is specified by 
ields of the TRACE 
eneral registers are 
g order of register 
ith general register 
up to and including 
* with general regis- 
eral register 15. 



The size of the trace entry for TRACE in 
units of words is 3 + (N + IK The 
maximum size of an entry is 19 words* or 
76 bytes. 



OPERATION 



When an instruction wh 
tracing is executed* a 
ing tracing function 
trace entry of the app 
made. The real addr 
entry is formed by a 
bits on the right to 
positions 1-29 of con 
The address in contro 
subsequently increase 
the entry created. 



i ch is subject to 
nd the correspond- 

is turned on* a 
ropriate format is 
ess of the trace 
ppending two zero 

the value in bit 
trol register 12. 
1 register 12 is 
d by the size of 



No trace entry is stored 
menting of the address in 
ter 12 would cause a 
propagated into bit posi 
is* the trace-entry addres 
the next 4K-byte block), 
be the case for the entry 
trace-table exception i 
For the purpose of re 
trace-table exception in 
TRACE instruction* the max 
76 bytes is used instead 
length. 



if the incre- 

control regi 5- 

carry to be 

tion 19 (that 

5 would be in 

If thi s would 

to be made* a 

s recognized. 

cognizing the 

the case of a 

imum length of 

of the actual 



The storing of a trace entry is not 
subject to key-controlled protection 
(nor, since the trace-entry address is 
real* is it subject to page protection)* 
but it is subject to low-address 
protection* that is* if the address of 
the trace entry due to be created is in 
the range 0-511 and bit 3 of control 
register is one* a protection excep- 
tion is recognized* and instruction 
execution is suppressed. If the address 
of a trace entry is invalid* an address- 
ing exception is recognized* and 
instruction execution is suppressed. 

The three exceptions associated with 
storing a trace entry (addressing* 
protection* and trace table) are collec- 
tively referred to as trace exceptions. 



if 
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I 



If a program interruption 
for a condition uhich is 
exception condition and 
execution of an instruc 
completed* it is unpredict 
part or all of any trace en 
made for such an interrupte 
is stored in the trace tabl 
a condition which would ord 
nullification or suppressio 
tion execution, storage 1 
have been altered begin 
location designated by con 
12 and extending up to the 
entry that would have been 



takes place 
not a trace- 
for which 
tion is not 
able whether 
try due to be 
d instruction 
e. Thus, for 
inarily cause 
n of instruc- 
ocations may 
ning at the 
trol register 
length of the 
created. 



The order in which information is placed 
in a trace entry is unpredictable. 
Furthermore, as observed by other CPUs 
and by channel programs, the contents of 
a byte of a trace entry may appear to 
change more than once before completion 
of the instruction for which the entry 
i s made. 

The trace-entry address in control 
register 12 is updated only on 
completion of execution of an instruc- 
tion for which a trace entry is made. 

A serialization and checkpoint-synch- 
ronization function is performed before 
the operation begins and again after the 
operation is completed. 



PROGRAM-EVENT RECORDING 



The program-event-recording (PER) facil- 
ity is provided to assist in debugging 
programs. It permits the program to be 
alerted to the following types of 
events: 



Execution of a 
instructi on. 



successful branch 



Fetching of an instruction from the 
designated storage area. 



Alteration of the contents 
designated storage area. 



of the 



Alteration of the contents 
designated general registers. 



of 



The program can selectively specify that 
one or more of the above types of events 
be recognized. The information concern- 
ing a PER event is provided to the 
program by means of a program inter — 
ruption, with the cause of the 
interruption being identified in the 
interruption code. 



CONTROL-REGISTER ALLOCATION 



The information for controlling PER 
resides in control registers 9, 10, and 



11 and has the following format? 
Control Register 9 



EM 




Gen. -Reg. Masks 



16 



31 



Control Register 10 



Starting Address 



1 



Control Register 11 



31 



Ending Address 



1 



31 



PER-Event Masks (EM): Bits 0-3 of 
control register 9 specify which types 
of events are recognized. The bits are 
assigned as follows: 

Bit 0: Successful-branching event 
Bit 1: Instruction-fetching event 
Bit 2: Storage-alteration event 
Bit 3: General-regi stei — alteration 
event 



Bits 0-3, when ones, 
corresponding types of 
nized. When a bit is 
sponding type of 
recogni zed. 



specify that the 
events be recog- 

zero, the corre- 
event is not 



Gene 




ral-Regi ster Ma 
rol register 

registers are 
ion of the alt 
. The 16 bits, 
ding bit number 
with the 16 r 
of ascending 
it is one, the 
ed regi ster i s 
ro, the alterat 
ot recognized. 



sks: Bits 16-31 

9 specify which 

designated for 

eration of their 

in the sequence 

s, correspond one 

egisters, in the 

register numbers. 

alteration of the 

recognized; when 

ion of the regis- 



PER Starting Address : Bits 1-31 of 
control register 10 are the address of 
the beginning of the designated storage 
area. 

PER Ending Address : Bits 1-31 of 
control register 11 are the address of 
the end of the designated storage area. 



Programme ng Notes 



1. Models may operate at reduced 
performance while the CPU is 
enabled for PER events. In order 
to ensure that CPU performance is 
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not degraded because 
tion of the PER faci 
that do not use it 
the CPU for PER even 
either the PER mask 
zero or the PER-ev 
control register 9 
both. No degradatio 
occurs when either o 
is zero. 



of the opera- 
lity, programs 
should disable 
ts by setting 
in the PSW to 
ent masks in 

to zero* or 
n due to PER 
f these fields 



2. Some degradation may be experienced 
on some models every time control 
registers 9, 10, and 11 are loaded, 
even when the CPU is disabled for 
PER events (see the programming 
note under "Storage-Area Desig- 
nation") . 



OPERATION 



PER is under control of bit 1 of the 
PSW, the PER mask. When the PER mask, a 
particular PER-event mask bit, and, for 
general-regi stei — alteration events, a 
particular general-register mask bit are 
all ones, the CPU is enabled for the 
corresponding type of event; otherwise, 
it is disabled. 

An interruption due to a PER event 
normally occurs after the execution d¥ 
the instruction responsible^ for the 
event. The occurrence of the event does 
not affect the execution of the instruc- 
tion, which may be either completed, 
partially completed, terminated, 
suppressed, or nullified. 

When the CPU is disabled for a partic- 
ular PER event at the time it occurs, 
either by the PER mask in the PSW or by 
the masks in control register 9, the 
event is not recognized. 



A change to the PER mask 
to the PER control fie 
registers 9, 10, and 1 
starting with the executi 
diately following instruc 
event occurs during the 
instruction which change 
being enabled to being di 
type of event, that PER 
ni zed. 



in the PSW or 
Ids in control 
1 affects PER 
on of the imme- 
tion. If a PER 
execution of an 
s the CPU from 
sabled for that 
event is recog- 



may be 
^>f an in 
quently the ins 
entries, and opera 
for the actual 
ref etched field was 
CPU or by a channe 
trial execution 
execution, it is u 
the PER events in 
trial or the actual 



recognized in a' trial 
struction, and subse- 
truction, DAT-table 
nds may be refetched 
execution. If any 

modified by another 
1 program between the 

and the actual 
npredictable whether 
dicated are for the 
execution. 



For special-purpose instructions that 
are not described in this publication, 



the operation of PER may not be exactly 
as described in this section. 



Identi f i cation of Cause 



A program interruption for PER sets bit 
8 of the interruption code to one and 
places identifying information in real 
storage locations 150-155. The informa- 
tion stored has the following format: 



Locations 150-151: 



PERC 


000000000000 



15 



Locations 152-155: 



PER Address 



31 



PER Code ( PERC ): The occurrence of PER 
events is indicated by ones in bit posi- 
tions 0-3 of real location 150, the PER 
code. The bit position in the PER code 
for a particular type of event is the 
same as the bit position for that event 
in the PER-event-mask field in control 
register 9. When a program interruption 
occurs, more than one type of PER event 
can be concurrently indicated. Addi- 
tionally, if another program- 
interruption condition exists, the 
interruption code for the program inter- 
ruption may indicate both the PER events 
and the other condition. Zeros are 
stored in bit positions 4-7 of location 
150 and in bit positions 0-7 of location 
151. 



PER Address : 
locations 152- 
tion address u 
tion in execu 
event 5 were 
instruction i 
the instructi 
the EXECUTE in 
PER-address fi 
bit position 



The '« „£,§£,, 
155 contains 
sed to "fetch 
li on when one 

recognized, 
s the target 
on address u 
struction is 
eld. A zero 

of real loca 



4dd£As9 at 
the instruc- w 
the instruct 
or more PERi 
When the 
of EXECUTE, 
sed to fetch 
placed in the 
is stored in 
tion 152. 



Instruction Address : The instruction 
address in the program old PSW is the 
address of the instruction which would^ 
finrg*BSBfrwt*eft*d hex#, unless another 
program condition is also indicated, in 
which case the instruction address is 
that determined by the instruction 
ending due to that condition. 

ILC: The ILC indicates the length of 
the instruction designated by the PER 
address, except when a concurrent spec- 
ification exception for the PSW intro- 



4-12 370-XA Principles of Operation 



duced by LOAD PSW or a supervisor-call 
interruption sets an ILC of 0. 



condition, or without the CPU enter- 
ing the stopped state. 



Priori tv of Indi cati on 



Programming Notes 



When a program interruption occurs and 
more than one PER event has been recog- 
nized, all recognized PER events are 
concurrently indicated in the PER code. 
Additionally, if another program- 
interruption condition concurrently 
exists, the interruption code for the 
program interruption indicates both the 
PER condition and the other condition. 

In the case of an instruction-fetching 
event for SUPERVISOR CALL, the program 
interruption occurs immediately after 
the supervisor-call interruption. 

If a PER event is recognized during the 
execution of an instruction which also 
introduces a new PSW with the type of 
PSW-format error which is recognized 
early (see the section "Exceptions Asso- 
ciated with the PSW" in Chapter 6, 
"Interruptions"), both the specification 
exception and PER are indicated concur- 
rently in the interruption code of the 
program interruption. However, for a 
PSW-format error of the type which is 
recognized late, only PER is indicated 
in the interruption code. In both 
cases, the invalid PSW is stored as the 
program old PSW. 



■^C'd'^'f^T'son ;,' ""' of 
v-rio rmaiiy'f af f ec-t 

-ti« ; iixeeWiWf 



a , p:pR e Ve nt does .not 
the^ ending of /irtstr^uc^ 
However, in the follow- 
ing cases, execution of an i nterrupti ble 
instruction is not completed normally: 

• When the instruction is due to be 
interrupted for an asynchronous 
condition (I/O, external, restart, 
or repressible machine-check condi- 
tion), a program interruption for 
the PER event occurs first, and the 
other interruptions occur subse- 
quently (subject to the mask bits in 
the new PSW) in the normal priority 
order. 

• When the stop function is performed, 
a program interruption indicating 
the PER event occurs before the CPU 
enters the stopped state. 

• When any program exception is recog- 
nized, PER events recognized for 
that instruction execution are indi- 
cated concurrently. 

• Depending on the model, in certain 
situations, recognition of a PER 
event may appear to cause the 
instruction to be interrupted prema- 
turely without concurrent indication 
of a program exception, without an 
interruption for any asynchronous 



4. 



In the following cases, an instruc- 
tion can both cause a program 
interruption for a PER event and 
change the value of masks control- 
ling an interruption for PER 
events. The original mask values 
determine whether a program intei — 
ruption takes place for the PER 
event. 



a 



The instructions LOAD PSW, SET 
SYSTEM MASK, STORE THEN AND 
and SUPERVISOR 
an instruction- 
and disable the 
i nterrupti ons. 
STORE THEN AND 
can cause a 
storage-alteration event to be 
indicated. In all these cases, 
the program old PSW associated 
with the program interruption 
for the PER event may indicate 
that the CPU was disabled for 
PER events. 



SYSTEM MASK, 
CALL can cause 
fetching event 
CPU for PER 
Addi ti onally, 
SYSTEM MASK 



An instruct 
may be 
execution o 
i nstructi on 
value of the 
control reg 
addresses in 
10 and 11 
cation of i 
events. 



ion-fetching event 

recognized during 

f a LOAD CONTROL 

that changes the 

PER-event masks in 

i ster 9 or the 

control registers 

controlling indi- 

nstructi on-f etchi ng 



No instruction can both change the 
values of general-regi stei — altera- 
tion masks and cause a general- 
regi stei — alteration event to be 
recognized. 

When a PER interruption occurs 
during the execution of an intei — 
ruptible instruction, the ILC indi- 
cates the length of that 
instruction or EXECUTE, as appro- 
priate. When a PER interruption 
occurs as a result of LOAD PSW or 
SUPERVISOR CALL, the ILC indicates 
the length of these instructions or 
EXECUTE, as appropriate, unless a 
concurrent specification exception 
on LOAD PSW calls for an ILC of 0. 



When a P 
by branch 
tifies th 
EXECUTE, 
the old 
instructi 
the inter 
execution 
i nstructi 



ER i nterrupti o 

ing, the PER a 

e branch inst 

as appropriat 

PSW points t 

on to be exec 

ruption occurs 

of an i 

on, the PER 



n i s caused 
ddress i den- 
ruction (or 
e), whereas 
o the next 
uted. When 
during the 
nterruptible 
address and 
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the instruction address 
PSW are the same. 



STORAGE-AREA DESIGNATION 



in the old PER-event masks to one* may cause the 
TLB to be cleared of entries. This 
degradation may be experienced even when 
the CPU is disabled for PER events. 
Thus, when possible, the program should 
avoid loading control registers 9, 10, 
or 11. 



Two type 
fetchi ng 
i nvolve 

locati on 
address 
extends 
desi gnat 
control 
to the r 



of P 
and 
the -de 
* The s 
desi g 
i n co 
up to a 
ed by 
regi ste 
i ght of 



ER events 

storage 
si gnat i on ^o 
to rage area 
nated by 
ntrol reg 
nd includin 

the endin 
r 11. The 

the starti 



— inst 
altera 

f an a 
starts 
the s 

ister 

g the 1 

g addr 
area 

ng addr 



ruction 
tion -- 
rea i it 
at the 
tarti ng 
10 and 
ocati on 
ess in 
extends 
ess. 



An instruction-fetching event occurs 
whenever the first byte of - an inst rue" 
tion or the first byte of the target of 
an EXECUTE instruction is fetched from 
the designated area® A storage-? 

alteration event occurs when a store 
a,©eess i s made to the designated area bf 
using an 'Operand addR^s^j that is defined 
to be a logical of a vvrtUal addressf A 
storage-alteration event does not occur 
for a store access made with an operand 
address defined to be a real address. 

The set of addresses designated for 
instruction-fetching and storage- 
alteration events wraps around at 
address 2,147,483,647; that is, address 
is considered to follow address 
2,147,483,647. When the starting 
address is less than the ending address, 
the area is contiguous. When the start- 
ing address is greater than the ending 
address, the set of locations designated 
includes the area from the starting 
address to address 2,147,483,647 and the 
area from address to, and including, 
the ending address. When the starting 
address is equal to the ending address, 
only that one location is designated. 

Address comparison for instruction- 
fetching and storage-alteration events 
is always performed using 31-bit 
addresses. This is accomplished in the 
24-bit addressing mode by extending the 
virtual, logical, or instruction address 
on the left with seven zero bits before 
comparing it with the starting and 
ending addresses. 



Programmi ng Note 



In some models, performance of address- 
range checking is assisted by means of 
an extension to each page-table entry in 
the TLB. In such an implementation, 
changing the contents of control regis- 
ters 10 and 11 when the instruction- 
fetching or storage-alteration-event 
mask is one, or setting either of these 



PER EVENTS 



Successful Branching 



A successful-branching event occurs 
whenever one of the following instruc- 
tions causes branching: 

BRANCH AND LINK (BAL, BALR) 
BRANCH AND SAVE (BAS, BASR) 
BRANCH AND SAVE AND SET MODE 

(BASSM) 
BRANCH AND SET MODE (BSM) 
BRANCH ON CONDITION (BC, BCR) 
BRANCH ON COUNT (BCT, BCTR) 
BRANCH ON INDEX HIGH (BXH) 
BRANCH ON INDEX LOW OR EQUAL (BXLE) 

A successful-branching event also occurs 
whenever one of the following 
instructions is completed: 

PROGRAM CALL (PC) 
PROGRAM TRANSFER (PT) 

A successful-branching event causes a 
PER successful-branching event to be 
recognized if bit of the PER-event 
masks is one and the PER mask in the PSW 
i s one. 

A PER successful-branching event is 
indicated by setting bit of the PER 
code to one. 



Instruction Fetching 



An instruction-fetching event occurs if 
the first byte of the instruction is 
fetched from the storage area designated 
by control registers 10 and 11. An 
instruction-fetching event also occurs 
if the first byte of the target of 
EXECUTE is within the designated storage 
area. 

An instruction-fetching event causes a 
PER instruction-fetching event to be 
recognized if bit 1 of the PER-event 
masks is one and the PER mask in the PSW 
is one. 

The PER instruction-fetching event is 
indicated by setting bit 1 of the PER 
code to one. 
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Storage Alteration 



A storage-alteration event occurs when- 
ever a CPU* by using a logical or virtu- 
al address* makes a store access without 
an access exception to the storage area 
designated by control registers 10 and 
11. 

The contents of storage are considered 
to have been altered whenever the CPU 
executes an instruction that causes all 
or part of an operand to be stored with- 
in the designated storage area. Alter- 
ation is considered to take pla$e 
whenever storing is considered to take 
place for purposes of indicating 
protection exceptions*, except tha«fe 
recognition does not occur for the stor- 
ing of data by a channel program. (See 
the section "Recognition of Access 
Exceptions" in Chapter 6, "Interrup- 
tions.") Storing constitutes alteration 
for PER purposes even if the value 
stored is the same as the original 
value. 



Implied locat 
by the CPU in 
an interrupti 
locations i nc 
code location 
er, are moni 
stored there 
ti on. Simi 1 
apply to the 
nel program. 



ions that are referred to 
the process of performing 
on are not monitored. Such 
lude PSW and i nterrupti on- 
s. These locations, howev- 
tored when information is 
explicitly by an instruc- 
arly, monitoring does not 
storing of data by a chan- 



The I/O instructions are considered to 
alter the second-operand location only 
when storing actually occurs. 

When an i nterrupti ble vector instruction 
which performs storing is interrupted, 
and PER storage alteration applies to 
storage locations corresponding to 
elements due to be changed beyond the 
point of interruption, PER storage 
alteration is indicated if any such 
store actually occurred and may be indi- 
cated even if such a store did not 
occur. PER storage alteration is 
reported for such locations only if no 
access exception exists at the time that 
the instruction is executed. 

Storage alteration does not apply to 
instructions whose operands are speci- 
fied to be real addresses. Thus, stor- 
age alteration does not apply to 
INVALIDATE PAGE TABLE ENTRY, RESET 
REFERENCE BIT EXTENDED, SET STORAGE KEY 
EXTENDED, TEST BLOCK, and TEST PENDING 
INTERRUPTION (when the effective address 
is zero). 

A storage-alteration event causes a PER 
storage-alteration event to be recog- 
nized if bit 2 of the PER-event masks is 
one and the PER mask in the PSW is one. 



A PER storage-alteration event is indi- 
cated by setting bit 2 of the PER code 
to one. 



General-Regi ster Alterati on 



A general-regi stei — alteration event 
occurs whenever the contents of a genei — 
al register are replaced. 

The contents of a general register are 
considered to have been altered whenever 
a new value is placed in the register. 
Recognition of the event is not contin- 
gent on the new value being different 
from the previous one. The execution of 
an RR-format arithmetic, logical, or 
movement instruction is considered to 
fetch the contents of the register, 
perform the indicated operation, if any, 
and then replace the value in the regis- 
ter. A register can be designated by an 
RR, RRE, RS, or RX instruction or 
implicitly, such as in TRANSLATE AND 
TEST and EDIT AND MARK. 

The instructions MOVE LONG and COMPARE 
LOGICAL LONG are always considered to 
alter the contents of the four registers 
specifying the two operands, including 
the cases where the padding byte is 
used, when both operands have zero 
length. However, when condition code 3 
is set for MOVE LONG, the general regis- 
ters containing the operand lengths may 
or may not be considered as having been 
altered. 

The instruction INSERT CHARACTERS UNDER 
MASK is not considered to alter the 
general register when the mask is zero. 

The instructions COMPARE AND SWAP and 
COMPARE DOUBLE AND SWAP are considered 
to alter the general register, or 
general-register pair, designated by R t , 
only when the contents are actually 
replaced, that is, when the first and 
second operands are not equal. 

It is unpredictable whether general- 
regi stei — alteration events are indicated 
for instructions of the vector facility. 

A general-regi stei — alteration event 
causes a PER general-regi stei — alteration 
event to be recognized if bit 3 of the 
PER-event masks is one, the PER mask in 
the PSW is one, and the corresponding 
bit in the PER general-register mask is 
one. 

The PER general-register-alteration 
event is indicated by setting bit 3 of 
the PER code to one. 
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Programme ng Note 



The following are some examples of 
general-register alteration: 

1. Register-to-register load instruc- 
tions are considered to alter the 
register contents even when both 
operand addresses designate the 
same register. 

2. Addition or subtraction of zero and 
multiplication or division by one 
are considered to constitute altei — 
ati on. 

3. Logical and fixed-point shift oper- 
ations are considered to alter the 
register contents even for shift 
amounts of zero. 



exception prohibits access to all 
or a portion of the target of 
EXECUTE, it is unpredictable wheth- 
er the instruction-fetching events 
for EXECUTE and the target are 
i ndi cated. 

2. When the operation is completed or 
partially completed, the event is 
indicated, regardless of whether 
any program exception, space-switch 
event, or monitor event is also 
recognized. 

3. Successful branching, storage 
alteration, and general-register 
alteration are not indicated for an 
operation or, in case the instruc- 
tion is i nterrupti ble, for a unit 
of operation that is suppressed or 
nulli f ied. 



The branching instructions BRANCH 
ON INDEX HIGH and BRANCH ON INDEX 
LOW OR EQUAL are considered to 
alter the first operand even when 
zero is added to its value. 



INDICATION OF PER EVENTS CONCURRENTLY 
WITH OTHER INTERRUPTION CONDITIONS 



When the execution of 
tion is terminate 
register or storage a 
indicated whenever th 
occurred, and a model 
the event if the even 
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instruction been compl 
altering the contents 
field is contingent 
values. 
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The following rules govern the indi- 
cation of PER events caused by an 
instruction that also causes a program 
exception, a monitor event, a space- 
switch event, or a supervisor-call 
i nterrupti on. 

1. The indication of an .instruction- 
fetching event does not depend on 
whether the execution of the 
instruction was completed, termi- 
nated, suppressed, or nullified. 
The event, however, is not indi- 
cated when an access exception 
prohibits access to the first half- 
word of the instruction. When the 
first halfword of the instruction 
is accessible but an access excep- 
tion applies to the second or third 
halfword of the instruction, it is 
unpredictable whether the 
instruction-fetching event is indi- 
cated. Similarly, when an access 



5. When LOAD PSW, SET SYSTEM MASK, 
STORE THEN OR SYSTEM MASK, or 
SUPERVISOR CALL causes a PER condi- 
tion and at the same time intro- 
duces a new PSW with the type of 
PSW-format error that is recognized 
immediately after the PSW becomes 
active, the interruption code iden- 
tifies both the PER condition and 
the specification exception. When 
LOAD PSW or SUPERVISOR CALL intro- 
duces a PSW-format error of the 
type that is recognized as part of 
the execution of the following 
instruction, the PSW is stored as 
the old PSW without the specifica- 
tion exception being recognized. 

The indication of PER events concurrent- 
ly with other program-interruption 
conditions is summarized in the figure 
"Indication of PER Events with Other 
Concurrent Conditions." 
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Concurrent Condition 



Type 

of 

Ending 



PER Event 



Branch 



Instr 
Fetch 



Storage 
Alter. 



GR 
Alter, 



Speci f i cation 

Odd instruction address 
in the PSW 
Instruction access 

Fi rst halfword 

Second* third halfwords 
Speci f i cat i on 

EXECUTE target address odd 
EXECUTE target access 
Other nullifying 
Other suppressing 
All terminating 
All completing 



or 
or 

S 

or 

N 

S 

T 

C 



No 



No 
No 

No 
No 
No 
No 
No 
Yes 



No 



No 
U 

U 

U 

Yes 

Yes 

Yes 

Yes 



No 



No 
No 

No 

No 

No x 

No 1 

Yes 2 

Yes 



No 



No 
No 

No 

No 

No 1 

No 1 

Yes 2 

Yes 



Explanati on 



) 



1 Although PER events of this type are not indicated for 
the current unit of operation of an i nterrupti ble in- 
struction, PER events of this type that were recognized 
on completed units of operation of the i nterrupti ble 
instruction are indicated. 

2 This event may be indicated* depending on the model* if 
the event has not occurred but Mould have been indicated 
if execution had been completed. 

C The operation or* in the case of the interruptible in- 
structions* the unit of operation is completed. 

N The operation or* in the case of the interruptible in- 
structions* the unit of operation is nullified. 

S The operation or* in the case of the interruptible in- 
structions* the unit of operation is suppressed. 

T The execution of the instruction is terminated. 

Yes The PER event is indicated with the other program- 
interruption condition if the event has occurred; that 
is* the contents of the designated storage location or 
general register were altered, or an attempt was made 
to execute an instruction whose first byte is located 
in the designated storage area. 

No The PER event is not indicated. 

U It is unpredictable whether the PER event is indicated. 



Indication of PER Events with Other Concurrent Conditions 



Programmi ng Notes 



The execution of the interruptible 
instructions MOVE LONG, TEST BLOCK* 
and COMPARE LOGICAL LONG can cause 
events for general-register altei — 
ation and instruction fetching. 
Additionally* MOVE LONG can cause 
the storage-alteration event. 

Interruption of such an instruction 
may cause a PER event to be indi- 
cated more than once. It may be 



necessary, therefore, for a program 
to remove the redundant event indi- 
cations from the PER data. The 
following rules govern the indi- 
cation of the applicable events 
during execution of these 
i nstructi ons: 

a. The instruction-fetching event 
is indicated whenever the 
instruction is fetched for 
execution, regardless of wheth- 
er it is the initial execution 
or a resumption. 
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2. 



b. The general-regi ster-alteratiort 
event is indicated on the 
initial execution and on each 
resumption and does not depend 
on whether or not the register 
actually is changed. 

c. The storage-alteration event is 
indicated only when data has 
been stored in the designated 
storage area by the portion of 
the operation starting with the 
last initiation and ending with 
the last byte transferred 
before the interruption. No 
special indication is provided 
on premature interruptions as 
to whether the event will occur 
again upon the resumption of 
the operation. When the desig- 
nated storage area is a single 
byte location, a storage- 
alteration event can be 
recognized only once in the 
execution of MOVE LONC. 

The following is an outline of the 
general action a program must take 
to delete multiple entries in the 
PER data for an interrupti ble 
instruction so that only one entry 
for each complete execution of the 
instruction is obtained: 

a. Check to see if the PER address 
is equal to the instruction 
address in the old PSW and if 
the last instruction executed 
was interruptible. 

b. If both conditions ar& met, 
delete instruction-fetching and 
register-alteration events. 

c. If both conditions are met and 
the event is storage 
alteration, delete the event if 
some part of the remaining 
destination operand is within 
the designated storage area. 



TIMING 



The timing facilities include three 
facilities for measuring time: the TOD 
clock, the clock comparator* and the CPU 
timer. 

In a multiprocessing configuration, a 
single TOD clock may be shared by more 
than one CPU, or each CPU may have a 
separate TOD clock. However, each CPU 
has a separate clock comparator and CPU 
timer. 



TIME-OF-DAY CLOCK 



The time-of-day (TOD) clock provides a 
high-resolution measure of real time 
suitable for the indication of date and 
time of day. The cycle of the clock is 
approximately 143 years. 

In an installation with more than one 
CPU, each CPU may have a separate TOD 
clock, or more than one CPU may share a 
clock, depending on the model. In all 
cases, each CPU has access to a single 
clock. 



Format 



The TOD clock is a binary counter with 
the format shown in the following illus- 
tration. The bit positions of the clock 
are numbered to 63, corresponding to 
the bit positions of a 64-bit unsigned 
binary integer. 



1 microsecond- 



51 



63 



1 s 



In the basic form, the TOD clock i = 
incremented by adding a one in bit posi- 
tion 51 every microsecond. In models 
having a higher or lower resolution, a 
different bit position is incremented at 
such a frequency that the rate of 
advancing the clock is the same as if a 
one were added in bit position 51 every 
microsecond. The resolution of the TOD 
clock is such that the incrementing rate 
is comparable to the instruction- 
execution rate of the model. 

A TOD clock is said to be in a partic- 
ular multiprocessing configuration if at 
least one of the CPUs which shares that 
clock is in the configuration. Thus, it 
is possible for a single TOD clock to be 
in more than one configuration. 
Conversely, if all CPUs having access to 
a particular TOD clock have been removed 
from a particular configuration, then 
the TOD clock is no longer considered to 
be in that configuration. 

When more than one TOD clock exists in 
the configuration, the stepping rates 
are synchronized such that all TOD 
clocks in the configuration are incre- 
mented at exactly the same rate. 

When incrementing of the clock causes a 
carry to be propagated out of bit posi- 
tion 0, the carry is ignored, and count- 
ing continues from zero. The program is 
not alerted, and no interruption condi- 
tion is generated as a result of the 
overflow. 
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The operation of the clock is not 
affected by any normal activity or event 
in the system. Incrementing of the 
clock does not depend on whether the 
wait-state bit of the PSW is one or 
whether the CPU is in the operating, 
load, stopped, or check-stop state. Its 
operation is not affected by CPU, 
initial-CPU, or clear resets or by 
initial program loading. Operation of 
the clock is also not affected by the 
setting of the rate control or by an 
initial-mi croprogram-loadi ng opera ti on. 
Depending on the model and the config- 
uration, a TOD clock may or may not be 
powered independent of a CPU that 
accesses it. 
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Incrementing of the clock begins with 
the first stepping pulse after the clock 
enters the set state. 



States 



The following states are distinguished 

for the TOD clock: set, not set, 

stopped, error, and not operational. 

The state determines the condition code 

set by execution of STORE CLOCK. The 

clock is incremented, and is said to be 

running, when it is in either the set 
state or the not-set state. 



When the clock is in the set state, 
execution of STORE CLOCK causes condi- 
tion code to be set and the current 
value of the running clock to be stored. 

Error State ? The clock enters the error 
state when a malfunction is detected 
that is likely to have affected the 
validity of the clock value. A timing- 
faci 1 i ty-damage machi ne-check-i nterrup- 
tion condition is generated on each CPU 
which has access to that clock whenever 
it enters the error state. 



> 



) 



Not-Set State : When the power for the 
clock is turned on, the clock is set to 
zero, and the clock enters the not-set 
state. The clock is incremented when in 
the not-set state. 

When the clock is in the not-set state, 
execution of STORE CLOCK causes condi- 
tion code 1 to be set and the current 
value of the running clock to be stored. 



Stopped State ? 
stopped state wh 
on a CPU access 
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When the clock is in the stopped state, 
execution of STORE CLOCK on a CPU 
accessing that clock causes condition 
code 3 to be set and the value of the 
stopped clock to be stored. 

Set State : The clock enters the set 
state only from the stopped state. The 
change of state is under control of the 
TOD-clock-sync-control bit, bit 2 of 
control register 0, in the CPU which 
most recently caused that clock to enter 
the stopped state. If the bit is zero, 
the clock enters the set state at the 
completion of execution of SET CLOCK. 



When STORE CLOCK is executed and the 
clock accessed is in the error state, 
condition code 2 is set, and the value 
stored is zero. 



Not-Qperati onal State : 
the not-operational sta 
is off or when it is d 
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Whenever the clock 
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When the clock is in the not-operational 
state, execution of STORE CLOCK causes 
condition code 3 to be set, and zero is 
stored. 



Changes in Clock State 



When the TOD clock accessed by a CPU 
changes value because of the execution 
of SET CLOCK or changes state, inter- 
ruption conditions pending for the clock 
comparator, CPU timer, and TOD-clock- 
sync check may or may not be recognized 



for up to 1.048576 seconds 
seconds) after the change. 



C2 



20 



mi cro- 



The results of channel-subsystem- 
moni tori ng-faci li ty operations may be 
unpredictable as a result of changes to 
the TOD clock. 
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Setting and Inspecting the Clock 



The clock can be set to a specific value 



by execution of SET 
TOD-clock control 



CLOCK if the manual 
of any CPU in the 



configuration is in the enable-set posi- 



ti on. 
values 



Setting the 
in all bi t 



clock replaces 
positions from 



the 
bit 



position through the rightmost posi- 
tion that is incremented when the clock 
is running. However, on some models* 
the rightmost bits starting at or to the 
right of bit 52 of the specified value 
are ignored, and zeros are placed in the 
corresponding positions of the clock. 

The TOD clock can be inspected by 
executing STORE CLOCK, which causes a 
64-bit value to be stored. Two 
executions of STORE CLOCK, possibly on 
different CPUs in the same 
configuration, always store different 
values if the clock is running or, if 
separate clocks are accessed, both 
clocks are running and are synchronized. 

The values stored for a running clock 
always correctly imply the sequence of 
execution of STORE CLOCK on one or more 
CPUs for all cases where the sequence 
can be established by means of the 
program. Zeros are stored in positions 
to the right of the bit position that is 
incremented. In a configuration with 
more than one CPU, however, when the 
value of a running clock is stored, 
nonzero values may be stored in posi- 
tions to the right of the rightmost 
position that is incremented. This 
ensures that a unique value is stored. 

In a configuration where more than one 
CPU accesses the same clock, SET CLOCK 
is interlocked such that the entire 
contents appear to be updated concui — 
rently; that is, if SET CLOCK 
instructions are executed simultaneously 
by two CPUs, the final result is either 
one or the other value. If SET CLOCK is 
executed on one CPU and STORE CLOCK on 
the other, the result obtained by STORE 
CLOCK is either the entire old value or 
the entire new value. When SET CLOCK is 
executed by one CPU, a STORE CLOCK 
executed on another CPU may find the 
clock in the stopped state even when the 
TOD-clock-sync-control bit is zero in 
each CPU. The TOD-clock-sync-control 
bit is bit 2 of control register 0. 
Since the clock enters the set state 
before incrementing, the first STORE 
CLOCK executed after the clock enters 
the set state may still find the 
original value introduced by SET CLOCK. 



the leftmost 32 bits of the clock 
may provide sufficient resolution. 

2. Communication between systems is 
facilitated by establishing a stan- 
dard time origin, or standard 
epoch, which is the calendar date 
and time to which a clock value of 
zero corresponds. January 1, 1900, 
a.m. Greenwich Mean Time (GMT) is 
recommended as the standard epoch 
for the clock. 

3. A program using the clock value as 
a time-of-day and calendar indi- 
cation must be consistent with the 
programming support under which the 
program is to be executed. If the 
programming support uses the stand- 
ard epoch, bit of the clock 
remains one through the years 
1972-2041. (Bit turned on at 
11:56:53.685248 (GMT) May 11, 
1971.) Ordinarily, testing bit 
for a one is sufficient to deter- 
mine if the clock value is in the 
standard epoch. 

4. Because of the limited accuracy of 
manually setting the clock value, 
the rightmost bit positions of the 
clock, expressing fractions of a 
second, are normally not valid as 
indications of the time of day. 
However, they permit elapsed-time 
measurements of high resolution. 

5. The following chart shows the time 
interval between instants at which 
various bit positions of the TOD 
clock are stepped. This time value 
may also be considered as the 
weighted time value that the bit, 
when one, represents. 



TOD- 

Clock 

Bit 


Stepping Interval 


Days 


Hours 


Mi n. 


Seconds 


51 
47 
43 




0.000 001 
0.000 016 
0.000 256 


39 
35 
31 




0.004 096 
0.065 536 
1.048 576 


27 
23 
19 


1 


16.777 216 

4 28.435 456 

11 34.967 296 


15 

11 

7 

3 


19 

12 17 

203 14 

3257 19 


5 19.476 736 
25 11.627 776 
43 6.044 416 
29 36.710 656 



Programming Notes 



Bit position 31 of the clock is 
incremented every 1.048576 seconds; 
for some applications, reference to 



The following chart shows the clock 
setting at the start of various 
years. The clock settings, 
expressed in hexadecimal notation, 
correspond to a.m. Greenwich 



\ 
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7. 



8. 



Mean Time on January 1 of 


year. 




Year 


Clock Setting (Hex) 


1900 


0000 0000 0000 0000 


1976 


8853 BAFO B400 0000 


1980 


8F80 9FD3 2200 0000 


1984 


96AD 84B5 9000 0000 


1988 


9DDA 6997 FE00 0000 


1992 


A507 4E7A 6C00 0000 


1996 


AC34 335C DA00 0000 


2000 


B361 183F 4800 0000 



each 



The stepping value of TOD-clock bit 
position 63, if implemented, is 
2- 12 microseconds, or approximately 
244 picoseconds. This value is 
called a clock unit. 

The following chart shows various 
time intervals in clock units 
expressed in hexadecimal notation. 



Interval 


Clock Units (Hex) 


1 microsecond 


1000 


1 mi Hi second 


3E 8000 


1 second 


F424 0000 


1 minute 


39 3870 0000 


1 hour 


D69 3A40 0000 


1 day 


1 41DD 7600 0000 


365 days 


1CA E8C1 3E00 0000 


366 days 


ICC 2A9E B400 0000 


1,461 days* 


72C E4E2 6E00 0000 


* Number of days in four years, 


including a leap year. Note 


that the year 1900 was not a 


leap year. Thus, the foui — 


year span starting in 1900 


has only 1460 days. 



In a multiprocessing configuration, 
after the TOD clock i s set and 
begins running, the program should 
delay activity for 2 20 microseconds 
(1.048576 seconds) to ensure that 
the CPU-timer, clock-comparator, 
and TOD-clock-sync-check intei — 
ruption conditions are recognized 
by the CPU. 



a multiprocessing configuration sharing 
a single TOD clock. The result is such 
that, to all programs storing the TOD- 
clock value, it appears that all CPUs in 
the configuration read the same TOD 
clock. The TOD-clock-synchroni zati on 
facility provides these functions in 
such a way that even though the number 
of CPUs sharing a TOD clock is model- 
dependent, a single model-independent 
clock-synchronization routine can be 
written. The following functions are 
provided: 

• Synchronizing the stepping rates 
for all TOD clocks in the config- 
uration. Thus, if all clocks are 
set to the same value, they stay in 
synchroni sm. 

• Comparing the rightmost 32 bits of 
each clock in the configuration. 
An unequal condition is signaled by 
an external interruption with the 
interruption code 1003 hex, indi- 
cating the TOD-clock-sync-check 
condi tion. 



Setting a 
state. 



TOD clock to the stopped 



Causing a stopped clock, with the 
TOD-clock-sync-control bit set to 
one, to start incrementing when 
bits 32-63 of any running clock in 
the configuration are incremented 
to zero. This permits the program 
to synchronize all clocks to any 
particular clock without requiring 
special operator action to select a 
"master clock" as the source of the 
clock-synchronization pulses. 



Programmi ng Notes 



TOD-clock synchronization provides 
for checking and synchronizing only 
the rightmost bits of the TOD 
clock. The program must check for 
synchronization of the leftmost 
bits and must communicate the 
leftmost-bit values from one CPU to 
another in order to correctly set 
the TOD-clock contents. 



> 



TOD-CLOCK SYNCHRONIZATION 



In an installation with more than one 
CPU, each CPU may have a separate TOD 
clock, or more than one CPU may share a 
TOD clock, depending on the model. In 
all cases, each CPU has access to a 
single clock. 

The TOD-clock-synchroni zation facility, 
in conjunction with a clock- 
synchronization program, makes it possi- 
ble to provide the effect of all CPUs in 



The TOD-clock-sync-check external 
interruption can be used to detei — 
mine the number of TOD clocks in 
the configuration. 



CLOCK COMPARATOR 



The clock comparator provides a means of 
causing an interruption when the TOD- 
clock value exceeds a value specified by 
the program. 
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In a configuration with more than one 
CPU, each CPU has a separate clock 
comparator. 

The clock comparator has the same format 
as the TOD clock. In the basic form, 
the clock comparator consists of bits 
0-47, which are compared with the corre- 
sponding bits of the TOD clock. In some 
models, higher resolution is obtained by 
providing more than 48 bits. The bits 
in positions provided in the clock 
comparator are compared with the corre- 
sponding bits of the clock. When the 
resolution of the clock is less than 
that of the clock comparator, the 
contents of the clock comparator are 
compared with the clock value as this 
value would be stored by executing STORE 
CLOCK. 

The clock comparator causes an external 
interruption with the interruption code 
1004 hex. A request for a clock- 
comparator interruption exists whenever 
either of the following conditions 
exi sts: 

1. The TOD clock is running and the 
value of the clock comparator is 
less than the value in the compared 
portion of the clock, both values 
being considered unsigned binary 
integers. Comparison follows the 
rules of unsigned binary 
ari thmetic. 

2. The TOD clock is in the error state 
or the not-operational state. 



A request for a 
ruption does not 
value of the clo 
equal to or great 
clock or when the 
i s made less the 1 
value. The latte 
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remain pending when the 
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The clock comparator can be inspected by 
executing the instruction STORE CLOCK 
COMPARATOR and can be set to a specific 
value by executing the SET CLOCK COMPA- 
RATOR instruction. 

The contents of the clock comparator are 
initialized to zero by initial CPU 
reset. 



Programming Notes 



An interruption request for the 
clock comparator persists as long 
as the clock-comparator value i s 
less than that of the TOD clock or 
as long as the TOD clock is in the 
error state or the not-operational 
state. Therefore, one of the 
following actions must be taken 
after an external interruption for 



the clock comparator has occurred 
and before the CPU is again enabled 
for external interruptions: the 
value of the clock comparator has 
to be replaced, the TOD clock has 
to be set, the TOD clock has to 
wrap to zero, or the clock- 
comparator-subclass mask has to be 
set to zero. Otherwise, loops of 
external interruptions are formed. 

The instruction STORE CLOCK may 
store a value which is greater than 
that in the clock comparator, even 
though the CPU is enabled for the 
clock-comparator interruption. 
This is because the TOD clock may 
be incremented one or more times 
between when instruction execution 
is begun and when the clock value 
is accessed. In this situation, 
the interruption occurs when the 
execution of STORE CLOCK is 
completed. 



CPU TIMER 



The CPU timer provides a means for meas- 
uring elapsed CPU time and for causing 
an interruption when a specified amount 
of time has elapsed. 

In a configuration with more than one 
CPU, each CPU has a separate CPU timer. 

The CPU timer is a binary counter with a 
format which is the same as that of the 
TOD clock, except that bit is consid- 
ered a sign. In the basic form, the CPU 
timer is decremented by subtracting a 
one in bit position 51 every 
microsecond. In models having a higher 
or lower resolution, a different bit 
position is decremented at such a 
frequency that the rate of decrementing 
the CPU timer is the same as if a one 
were subtracted in bit position 51 every 
microsecond. The resolution of the CPU 
timer is such that the stepping rate is 
comparable to the instruction-execution 
rate of the model. 

The CPU timer requests an external 
interruption with the interruption code 
1005 hex whenever the CPU-timer value is 
negative (bit of the CPU timer is 
one). The request does not remain pend- 
ing when the CPU-timer value is changed 
to a nonnegative value. 

When both the CPU timer and the TOD 
clock are running, the stepping rates 
are synchronized such that both are 
stepped at the same rate. Normally, 
decrementing the CPU timer is not 
affected by concurrent I/O activity. 
However, in some models the CPU timer 
may stop during extreme I/O activity and 
other similar interference situations. 
In these cases, the time recorded by the 
CPU timer provides a more accurate meas- 
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ure of the CPU time used by the program 
than would have been recorded had the 
CPU timer continued to step. 



The CPU tim 
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Depending on the model, the CPU timer 
may or may not be decremented when the 
CPU is in the check-stop state. 

The CPU timer can be inspected by 
executing the instruction STORE CPU 
TIMER and can be set to a specific value 
by executing the SET CPU TIMER instruc- 
ti on. 

The CPU timer is set to zero by initial 
CPU reset. 



Programming Notes 



The CPU timer in association with a 
program may be used both to measure 
CPU-execution time and to signal 
the end of a time interval on the 
CPU. 

The time measured for the execution 
of a sequence of instructions may 
depend on the effects of such 
things as I/O interference, the 
availability of pages, and instruc- 
tion retry. Hence, repeated 
measurements of the same sequence 
on the same installation may 
di ffer. 



timer is interrupted for a cause 
other than the CPU timer, external 
interruptions are disallowed by the 
new PSW, and the CPU-timer value is 
then saved by STORE CPU TIMER. 
This value could be negative if the 
CPU timer went from positive to 
negative since the interruption. 
Subsequently, when the program 
being timed is to continue, the CPU 
timer may be set to the saved value 
by SET CPU TIMER. A CPU-timer 
interruption occurs immediately 
after external interruptions are 
again enabled if the saved value 
was negative. 

The persistence of the CPU-timer- 
interruption request means, 
however, that after an external 
interruption for the CPU timer has 
occurred, the value of the CPU 
timer has to be replaced, the value 
in the CPU timer has to wrap to a 
positive value, or the CPU-timei — 
subclass mask has to be set to zero 
before the CPU is again enabled for 
external interruptions. Otherwise, 
loops of external interruptions are 
formed. 

5. The instruction STORE CPU TIMER may 
store a negative value even though 
the CPU is enabled for the intei — 
ruption. This is because the CPU- 
timer value may be decremented one 
or more times between when instruc- 
tion execution is begun and when 
the CPU timer is accessed. In this 
situation, the interruption occurs 
when the execution of STORE CPU 
TIMER is completed. 



EXTERNALLY INITIATED FUNCTIONS 



| 
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The fact that CPU-timer inter- 
ruptions are requested whenever the 
CPU timer is negative (rather than 
just when the CPU timer goes from 
positive to negative) eliminates 
the requirement for testing a value 
to ensure that it is positive 
before setting the CPU timer to 
that value. 

As an example, assume that a 
program being timed by the CPU 



RESETS 

Five reset functions are provided: 

CPU reset 

Initial CPU reset 

Subsystem reset 

Clear reset 

Power-on reset 

CPU reset provides a means of clearing 
equipment-check indications and any 
resultant unpredictability in the CPU 
state with the least amount of informa- 
tion destroyed. In particular, it is 
used to clear check conditions when the 
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CPU state i s to be preserved for analy- 
sis or resumption of the operation. 

Initial CPU reset provides the functions 
of CPU reset together with initializa- 
tion of the current PSW, CPU timer, 
clock comparator, prefix, and control 
regi sters. 

Subsystem reset provides a means for 
clearing floating interruption condi- 
tions as well as for invoking I/0-system 
reset. 

Clear reset causes initial CPU reset and 
subsystem reset to be performed and, 
additionally, clears or initializes all 
storage locations and registers in all 
CPUs in the configuration, with the 
exception of the TOD clock. Such clear- 
ing is useful in debugging programs and 
in ensuring user privacy. Clearing does 
not affect external storage, such as 
direct-access storage devices used by 
the control program to hold the contents 
of unaddressable pages. 



The power-on-reset sequences for the TOD 
clock, main storage, and the channel 
subsystem may be included as part of the 
CPU powei — on sequence, or the powei — on 
sequence for these units may be initi- 
ated separately. 

CPU reset, initial CPU reset, subsystem 
reset, and clear reset may be initiated 
manually by using the operator facili- 
ties (see Chapter 12, "Operator Facili- 
ties"). Initial CPU reset is part of 
the initial-program-loading function. 
The figure "Manual Initiation of Resets" 
summarizes how these four resets are 
manually initiated. Powei — on reset is 
performed as part of turning power on. 
The reset actions are tabulated in the 
figure "Summary of Reset Actions." 
information concerning what resets 
be performed by the SIGNAL PROCESSOR 
instruction, see the section "Signal- 
Processor Orders" in this chapter. 
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Manual Initiation of Resets 
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Area Affected 



Reset Function 
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Explanation : 
x 



Clearing the contents of the PSW to zero causes the PSW 
to be invalid. 

When the IPL sequence follows the reset function on that 
CPU* the CPU does not necessarily enter the stopped 
state, and the PSW is not necessarily cleared to zeros. 

When these units are separately powered, the action is 
performed only when the power for the unit is turned on. 

Access to change expanded storage at the time a reset 
function is performed may cause the contents of the 4K- 
byte block in expanded storage to be unpredictable. 
Access to examine expanded storage does not affect the 
contents of the expanded storage. 

Access to the TOD clock by means of STORE CLOCK at the 
time a reset function is performed does not cause the 
value of the TOD clock to be affected. 

When the channel subsystem is separately powered or con- 
sists of multiple elements which &re separately powered, 
the reset action is applied only to those subchannels, 
channel paths, and I/O control units and devices on those 
paths associated with the element which is being powered 
on. 

The condition or contents are cleared. If the area 
affected is a field, the contents are set to zero with 
valid checking-block code. 

The state or contents are initialized. If the area af- 
fected is a field, the contents are set to the initial 
value with valid checking-block code. 



> 



Summary of Reset Actions (Part 1 of 2) 
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Explanation (Continued): 

R I/0-system reset is performed in the channel subsystem. 
As part of this reset* system reset is signaled to all 
I/O control units and devices attached to the channel 
subsystem. 

S The CPU is reset; current operations* if any, are term- 
inated; the TLB is cleared of entries; interruption con- 
ditions in the CPU are cleared; and the CPU is placed in 
the stopped state. The effect of performing the start 
function is unpredictable when the stopped state has 
been entered by means of a reset. 

T The TOD clock is initialized to zero and validated; it 
enters the not-set state. 

U The state, condition, or contents of the field remain 
unchanged. However, the result is unpredictable if an 
operation is in progress that changes the state, con- 
dition, or contents of the field at the time of reset. 

U/V The contents remain unchanged, provided the field is not 
being changed at the time the reset function is pei — 
formed. However, on some models the checking-block code 
of the contents may be made valid. The result is un- 
predictable if an operation is in progress that changes 
the contents of the field at the time of reset. 



Summary of Reset Actions (Part 2 of 2) 



CPU Reset 



CPU reset causes the following actions: 

1. The execution of the current 
instruction or other processing 
sequence, such as an interruption, 
is terminated, and all program- 
interruption and supervisor-call- 
interruption conditions are 
cleared. 

2. Any pending external-interruption 
conditions which are local to the 
CPU are cleared. Floating 
external-interruption conditions 
are not cleared. 

3. Any pending machine-check-interrup- 
tion conditions and error indi- 
cations which are local to the CPU 
and any check-stop states are 
cleared. Floating machine-check- 
interruption conditions are not 
cleared. Any machine-check condi- 
tion which is reported to all CPUs 
in the configuration and which has 
been made pending to a CPU is said 
to be local to the CPU. 

4. All copies of prefetched 
instructions or operands are 
cleared. Additionally, any results 
to be stored because of the 
execution of instructions in the 
current checkpoint interval are 
cleared. 



5. The translation-lookaside buffer is 
cleared of entries. 

6. The CPU is placed in the stopped 
state after actions 1-5 have been 
completed. When the IPL sequence 
follows the reset function on that 
CPU, the CPU enters the load state 
at the completion of the reset 
function and does not necessarily 
enter the stopped state during the 
execution of the reset operation. 

Registers, storage contents, and the 
state of conditions external to the CPU 
remain unchanged by CPU reset. However, 
the subsequent contents of the register, 
location, or state are unpredictable if 
an operation is in progress that changes 
the contents at the time of the reset. 

When the reset function in the CPU is 
initiated at the time the CPU is execut- 
ing an I/O instruction or is performing 
an I/O interruption, the current opera- 
tion between the CPU and the channel 
subsystem may or may not be completed, 
and the resultant state of the associ- 
ated channel-subsystem facility may be 
unpredictable. 



Programming Note 



Most operations which would change a 
state, a condition, or the contents of a 
field cannot occur when the CPU is in 
the stopped state. However, some 
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signal-processor functions and some 
operator functions may change these 
fields. To eliminate the possibility of 
losing a field when CPU reset is issued, 
the CPU should be stopped, and no opera- 
tor functions should be in progress. 



Clear Reset 



Clear reset combines the initial-CPU- 
reset function with an initializing 
function which causes the following 
actions: 



Initial CPU Reset 



Initial CPU reset combines the CPU reset 
functions with the following clearing 
and initializing functions: 

1. The contents of the current PSW, 
prefix, CPU timer, and clock compa- 
rator are set to zero. When the 
IPL sequence follows the reset 
function on that CPU, the contents 
of the PSW are not necessarily set 
to zero. 

2. The contents of control registers 
are set to their initial value. 

These clearing and initializing func- 
tions include validation. 

Setting the current PSW to zero causes 
the PSW to be invalid, since PSW bit 12 
must be one. Thus, if the CPU is placed 
in the operating state after a reset 
without first introducing a new PSW, a 
specification exception is recognized. 



1. The general and floating-point 
registers of those CPUs which are 
in the configuration are set to 
zero. 

2. The registers of those vector 
facilities, if any, which are in 
the configuration are cleared. The 
registers of the vector facility 
(vector-status register, vectoi — 
mask register, vectoi — activity 
count, and all vector registers) 
are set to zero. 

3. The contents of the main storage in 
the configuration and the associ- 
ated storage keys are set to zero 
with valid checking-block code. 

4. A subsystem reset is performed. 

Validation is included in setting regis- 
ters and in clearing storage and storage 
keys. 



Programmi ng Notes 



Subsystem Reset 



Subsystem reset 
elements in the 
not CPUs. It 
acti ons: 



operates only on those 
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performs the following 



I/O-system reset is performed by 
the channel subsystem (see the 
section "I/0-System Reset" in Chap- 
ter 17, "I/O Support Functions"). 



All floating 
tions in the 
cleared. 



interruption condi- 
conf i gurati on are 



As part of I/O-system reset, pending 
I/O-interrupti on conditions are cleared, 
and system reset is signaled to all 
control units and devices attached to 
the channel subsystem (see the section 
"I/O-System Reset" in Chapter 17, "I/O 
Support Functions"). The effect of 
system reset on I/O control units and 
devices and the resultant control-unit 
and device state are described in the 
appropriate System Library publication 
for the control unit or device. A 
system reset, in general, resets only 
those functions in a shared control unit 
or device that are associated with the 
particular channel path signaling the 
reset. 



2. 



For the CPU-reset operation not to 
affect the contents of fields that 
are to be left unchanged, the CPU 
must not be executing instructions 
and must be disabled for all inter- 
ruptions at the time of the reset. 
Except for the operation of the CPU 
timer and for the possibility of a 
machine-check interruption occur- 
ring, all CPU activity can be 
stopped by placing the CPU in the 
wait state and by disabling it for 
I/O and external interruptions. To 
avoid the possibility of causing a 
reset at the time that the CPU 
timer is being updated or a 
machine-check interruption occurs, 
the CPU must be in the stopped 
state. 

CPU reset, initial CPU reset, 
subsystem reset, and clear reset do 
not affect the value and state of 
the TOD clock. 

The conditions under which the CPU 
enters the check-stop state are 
model-dependent and include 
malfunctions that preclude the 
completion of the current 
operation. Hence, if CPU reset or 
initial CPU reset is executed while 
the CPU is in the check-stop state, 
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the contents of the PSW, registers, 
and storage locations, including 
the storage keys and the storage 
location accessed at the time of 
the error, may have unpredictable 
values, and, in some cases, the 
contents may still be in error 
after the check-stop state is 
cleared by these resets. In this 
situation, a clear reset is 
required to clear the error. 



Power-On Reset 



The pouiei — on-reset function for a compo- 
nent of the machine is performed as part 
of the power-on sequence for that compo- 
nent. 

The power-on sequences for the TOD 
clock, vector facility, main storage, 
expanded storage, and channel subsystem 
may be included as part of the CPU 
power-on sequence, or the power-on 
sequence for these units may be initi- 
ated separately. The following sections 
describe the powei — on resets for the 
CPU, TOD clock, vector facility, main 
storage, expanded storage, and channel 
subsystem. See also Chapter 17, "I/O 
Support Functions," and the appropriate 
System Library publication for the chan- 
nel subsystem, control units, and I/O 
devices. 

CPU Power-On Reset : The power-on reset 
causes initial CPU reset to be performed 
and may or may not cause I/0-system 
reset to be performed in the channel 
subsystem. The contents of general 
registers and floating-point registers 
are cleared to zeros with valid 
checking-block code. 

TOD-Clock Power-On Reset : The power-on 
reset causes the value of the TOD clock 
to be set to zero and causes the clock 
to enter the not-set state. 

Vector-Faci 1 i ty Powei — On Re set : The 
power-on reset causes the registers of 
the vector facility (vectoi — status 
register, vector-mask register, vector- 
activity count, and all vector 
registers) to be cleared to zeros with 
valid checking-block code. 

Main-Storage Power-On Reset : For vola- 
tile main storage (one that does not 
preserve its contents when power is off) 
and for storage keys, power-on reset 
causes zeros with valid checking-block 
code to be placed in these fields. The 
contents of nonvolatile main storage, 
including the checking-block code, 
remain unchanged. 

Expanded-Storage Power-On Reset : The 
contents of the expanded storage are 
cleared to zero with valid checking- 
block code. 



Channel -Subsystem Power-On Reset : The 
channel-subsystem powei — on reset causes 
I/0-system reset to be performed in the 
channel subsystem. (See the section 
"I/0-System Reset" in Chapter 17, "I/O 
Support Functions.") 



INITIAL PROGRAM LOADING 



Initial program loading (IPL) provides a 
manual means for causing a program to be 
read from a designated device and for 
initiating execution of that program. 

Some models may provide additional 
controls and indications relating to 
IPL; this additional information is 
specified in the System Library publica- 
tion for the model. 

IPL is initiated manually by setting the 
load-unit-address controls to a foui — 
digit number to designate an input 
device and by subsequently activating 
the load-clear or load-normal key. 

Activating the load-clear key causes a 
clear reset to be performed on the 
conf i gurati on. 

Activating the load-normal key causes an 
initial CPU reset to be performed on 
this CPU, CPU reset to be propagated to 
all other CPUs in the configuration, and 
a subsystem reset to be performed on the 
remainder of the configuration. 

In the loading part of the operation, 
after the resets have been performed, 
this CPU then enters the load state. 
This CPU does not necessarily enter the 
stopped state during the execution of 
the reset operations. The load indica- 
tor is on while the CPU is in the load 
state. 

Subsequently, a channel program read 
operation is initiated from the I/O 
device designated by the load-unit- 
address controls. The effect of execut- 
ing the channel program is as if a 
format-0 CCW in absolute storage 
location specified a read command with 
the modifier bits zeros, a data address 
of zero, a byte count of 24, the chain- 
command and SLI flags ones, and all 
other flags zeros. 

The details of the channel-subsystem 
portion of the IPL operation are defined 
in the section "Initial Program Loading" 
in Chapter 17, "I/O Support Functions." 

When the IPL I/O operation is completed 
successfully, the subsystem-identifica- 
tion word of the IPL device is stored in 
absolute storage locations 184-187, 
zeros are stored in absolute storage 
locations 188-191, and a new PSW is 
loaded from absolute storage locations 
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0-7. If the PSW loading is successful 
and if no machine malfunctions are 
detected, this CPU leaves the load 
state, and the load indicator is turned 
off. If the rate control is set to the 
process position, the CPU enters the 
operating state, and the CPU operation 
proceeds under control of the new PSW. 
If the rate control is set to the 
instruction-step position, the CPU 
enters the stopped state, with the manu- 
al indicator on, after the new PSW is 
loaded. 

If the IPL I/O operation or the PSW 
loading is not completed successfully, 
the CPU remains in the load state, and 
the load indicator remains on. The 
contents of absolute storage locations 
0-7 are unpredictable. 



STORE STATUS 



The store-status operation places the 
contents of the CPU registers, except 
for the TOD clock, in assigned storage 
locations. 

The figure "Assigned Storage Locations 
for Store Status" lists the fields that 
are stored, their length, and their 
location in main storage. 



MULTIPROCESSING 

The multiprocessing facility provides 
for the interconnection of CPUs, via a 
common main storage, in order to enhance 
system availability and to share data 
and resources. The multiprocessing 
facility includes the following facili- 
ti es: 

• Shared main storage 

• CPU-to-CPU interconnection 
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The channel subsystem, including all 
subchannels, in a multiprocessing 
configuration can be accessed by all 
CPUs in the configuration. 1/0- 
interruption conditions are floating and 
can be accepted by any CPU in the 
conf i gurati on. 



Field 


Length 

i n 
Bytes 


Absolute 
Address 


CPU timer 

Clock comparator 

Current PSW 

Prefix 

Fl-pt registers 0-6 

General registers 0-15 

Control registers 0-15 


8 

8 

8 

4 

32 

64 

64 


216 
224 
256 
264 
352 
384 
448 



SHARED MAIN STORAGE 



Assigned Storage Locations for Store 
Status 
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The contents of the registers are not 
changed. If an error is encountered 
during the operation, the CPU enters the 
check-stop state. 

The store-status operation can be initi- 
ated manually by use of the store-status 
key (see Chapter 12, "Operator Facili- 
ties"). The store-status operation can 
also be initiated at the addressed CPU 
by executing SIGNAL PROCESSOR, specify- 
ing the stop-and-store-status order. 
Execution of SIGNAL PROCESSOR specifying 
the store-status-at-address order 
permits the same status information to 
be stored at a designated address (see 
"Signal Processor Orders" in this chap- 
ter). 



CPU-ADDRESS IDENTIFICATION 



Each CPU has a number assigned, called 
its CPU address. A CPU address uniquely 
identifies one CPU within a configura- 
tion. The CPU is designated by specify- 
ing this address in the CPU-address 
field of SIGNAL PROCESSOR. The CPU 
signaling a malfunction alert, emergency 
signal, or external call is identified 
by storing this address in the CPU- 
address field with the interruption. 
The CPU address is assigned during 
system installation and is not changed 
as a result of reconfiguration changes. 
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The program can determine the address of 
the CPU by using STORE CPU ADDRESS. 



CPU SIGNALING AND RESPONSE 



The CPU-si gnali ng-and-response facility 
consists of SIGNAL PROCESSOR and a mech- 
anism to interpret and act on several 
order codes. The facility provides for 
communications among CPUs* including 
transmitting, receiving, and decoding a 
set of assigned order codes; initiating 
the specified operation; and responding 
to the signaling CPU. A CPU can address 
SIGNAL PROCESSOR to itself. SIGNAL 
PROCESSOR is described in Chapter 10, 
"Control Instructions." 



SIGNAL-PROCESSOR ORDERS 



The signal-processor orders are speci- 
fied in bit positions 24-31 of the 
second-operand address of SIGNAL PROCES- 
SOR and are encoded as shown in the 
figure "Encoding of Orders." 



Code 


Order 


00 


Unassi gned 


01 


Sense 


02 


External call 


03 


Emergency signal 


04 


Start 


05 


Stop 


06 


Restart 


07 


Unassi gned 


08 


Unassi gned 


09 


Stop and store status 


0A 


Unassi gned 


0B 


Initial CPU reset 


OC 


CPU reset 


0D 


Set prefix 


0E 


Store status at address 


0F-FF 


Unassi gned 



Encoding of Orders 



The orders are defined as follows: 
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interruption condition becomes pending 
during the execution of SIGNAL 
PROCESSOR. The associated interruption 
occurs when the CPU is enabled for that 
condition and does not necessarily occur 
during the execution of SIGNAL 
PROCESSOR. The address of the CPU send- 
ing the signal is provided with the 
interruption code when the interruption 
occurs. Only one external-call condi- 
tion can be kept pending in a CPU at a 
time. The order is effective only when 
the addressed CPU is in the stopped or 
the operating state. 

Emergency Signal : An emergency-signal 
external-interruption condition is 
generated at the addressed CPU. The 
interruption condition becomes pending 
during the execution of SIGNAL 
PROCESSOR. The associated interruption 
occurs when the CPU is enabled for that 
condition and does not necessarily occur 
during the execution of SIGNAL 
PROCESSOR. The address of the CPU send- 
ing the signal is provided with the 
interruption code when the interruption 
occurs. At any one time the receiving 
CPU can keep pending one emergency- 
signal condition for each CPU in the 
configuration, including the receiving 
CPU itself. The order is effective only 
when the addressed CPU is in the stopped 
or the operating state. 
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External Call : An external-call 
external-interruption condition is 
generated at the addressed CPU. The 



Stop : The addressed CPU performs the 
stop function (see the section "Stopped, 
Operating, Load, and Check-Stop States" 
in this chapter). The CPU does not 
necessarily enter the stopped state 
during the execution of SIGNAL 
PROCESSOR. The order is effective only 
when the CPU is in the operating state. 

Restart : The addressed CPU performs the 
restart operation (see the section 
"Restart Interruption" in Chapter 6, 
"Interruptions"). The CPU does not 
necessarily perform the operation during 
the execution of SIGNAL PROCESSOR. The 
order is effective only when the 
addressed CPU is in the stopped or the 
operating state. 

Stop and Store Status : The addressed 
CPU performs the stop function, followed 
by the store-status function (see the 
section "Store Status" in this chapter). 
The CPU does not necessarily complete 
the operation, or even enter the stopped 
state, during the execution of SIGNAL 
PROCESSOR. The order is effective only 
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when the addressed CPU is in the stopped 
or the operating state. 

Initial CPU Reset ; The addressed CPU 
performs initial CPU reset (see the 
section "Resets" in this chapter). The 
execution of the reset does not affect 
other CPUs and does not cause I/O to be 
reset. The reset operation is not 
necessarily completed during the 
execution of SIGNAL PROCESSOR. 

CPU Reset : The addressed CPU performs 
CPU reset (see the section "Resets" in 
this chapter). The execution of the 
reset does not affect other CPUs and 
does not cause I/O to be reset. The 
reset operation is not necessarily 
completed during the execution of SIGNAL 
PROCESSOR. 

Set Prefix : The contents of bit posi- 
tions 1-19 of the parameter register of 
the SIGNAL PROCESSOR instruction are 
treated as a prefix value, which 
replaces the contents of the prefix 
register of the addressed CPU. Bit 
and bits 20-31 of the parameter register 
are ignored. The order is accepted only 
if the addressed CPU is in the stopped 
state, the value to be placed in the 
prefix register designates a location 
which is available in the configuration, 
and no other condition precludes accept- 
ing the order. Verification of the 
stopped state of the addressed CPU and 
of the availability of the designated 
storage is performed during execution of 
SIGNAL PROCESSOR. If accepted, the 
order is not necessarily completed 
during the execution of SIGNAL 
PROCESSOR. 

The parameter register has the following 
format: 



/ 


Prefix Value 


///////////// 



20 



31 



The set-prefix order is completed as 
follows: 

• If the addressed CPU is not in the 
stopped state, the order is not 
accepted. Instead, bit 22 (incoi — 
rect state) of the general register 
designated by the R t field of the 
SIGNAL PROCESSOR instruction is set 
to one, and condition code 1 is 
set. 



The value 
prefix regi 
CPU is tes 
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addressing mode. The 4K-byte block 
of storage at this address is 
accessed. The access is not 
subject to protection, and the 
associated reference bit may or may 
not be set to one. If the block is 
not available in the configuration, 
the order is not accepted by the 
addressed CPU, bit 23 (invalid 
parameter) of the general register 
designated by the R, field of the 
SIGNAL PROCESSOR instruction is set 
to one, and condition code 1 is 
set. 

The value is placed in the prefix 
register of the addressed CPU. 



The TLB of the addressed CPU 
cleared of its contents. 



1 s 



• A serializing and checkpoint- 
synchronizing function is performed 
on the addressed CPU following 
insertion of the new prefix value. 

Store Status at Address : The contents 
of bit positions 1-22 of the parameter 
register of the SIGNAL PROCESSOR 
instruction are used as the origin of a 
512-byte area into which the status of 
the addressed CPU is stored. Bit and 
bits 23-31 of the parameter register are 
i gnored. 

The order is accepted only if the 
addressed CPU is in the stopped state, 
the status-area origin designates a 
location which is available in the 
configuration, and no other condition 
precludes accepting the order. Verifi- 
cation of the stopped state of the 
addressed CPU and of the availability of 
the designated storage is performed 
during execution of SIGNAL PROCESSOR. 
If accepted, the order is not necessar- 
ily completed during the execution of 
SIGNAL PROCESSOR. 

The parameter register has the following 
format: 



/ 


Status-Area Origin 


///////// 



1 23 31 

The store-status-at-address order is 
completed as follows: 

• If the addressed CPU is not in the 
stopped state, the order is not 
accepted. Instead, bit 22 (incor- 
rect state) of the general register 
designated by the Ri field of the 
SIGNAL PROCESSOR instruction is set 
to one, and condition code 1 is 
set. 

• The address of the area into which 
status is to be stored is tested 
for availability. The absolute 
address of a 512-byte area of stor- 
age is formed by appending nine 
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zeros to the right of bits 1-22 of 
the parameter value. This address 
is treated as a 31-bit absolute 
address regardless of whether the 
sending and receiving CPUs are in 
the 24-bit or 31-bit addressing 
mode. The 512-byte block of stoi — 
age at this address is accessed. 
The access is not subject to 
protection, and the associated 
reference bit may or may not be set 
to one. If the block is not avail- 
able in the configuration, the 
order i s not accepted by the 
addressed CPU, bit 23 (invalid 
parameter) of the general register 
designated by the Ri field of the 
SIGNAL PROCESSOR instruction is set 
to one, and condition code 1 is 
set. 



facility. The CPU which is concur- 
rently executing the instruction 
can be any CPU in the configuration 
other than this CPU, and the CPU 
address can be any address, includ- 
ing that of this CPU or an invalid 
address. The order is rejected. 
Condition code 2 is set. 
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The status of the addressed CPU i s 
placed in the designated area. The 
information stored, and the format 
of the area receiving the informa- 
tion, are the same as for the 
stop-and-store-status order, except 
that each field, rather than being 
stored at an offset from the begin- 
ning of absolute storage, is stored 
in the designated area at an offset 
that is the same as that for the 
absolute area. Bytes 0-215, 
232-255, and 268-351 of the desig- 
nated area remain unchanged. (See 
the section "Store Status" in this 
chapter) . 

A serialization and checkpoint- 
synchronization function is 
performed on the addressed CPU 
following storing of the status. 



Programmi ng Note 



For a discussion on the relative 
performance of the SIGNAL PROCESSOR 
orders, see the programming note follow- 
ing the instruction SIGNAL PROCESSOR in 
Chapter 10, "Control Instructions." 



One of the following conditions 
exists at the addressed CPU: 

a. A previously issued start, 
stop, restart, stop-and-store- 
status, set-prefix, or store- 
status-at-address order has 
been accepted by the addressed 
CPU, and execution of the func- 
tion requested by the order has 
not yet been completed. 

b. A manual start, stop, restart, 
or store-status function has 
been initiated at the addressed 
CPU, and the function has not 
yet been completed. This 
condition cannot arise as a 
result of a SIGNAL PROCESSOR by 
a CPU addressing itself. 
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CONDITIONS DETERMINING RESPONSE 



One of the following conditions 
exists at the addressed CPU: 



Condi ti ons Precludi ng Interpretati on of 
the Order Code 



The following situations preclude the 
initiation of the order. The sequence 
in which the situations are listed is 
the order of priority for indicating 
concurrently existing situations: 

1. The access path to the addressed I 
CPU is busy because a concurrently 
executed SIGNAL PROCESSOR is using 
the CPU-si gnali ng-and-response 



a. A previously issued initial- 
CPU-reset or CPU-reset order 
has been accepted by the 
addressed CPU, and execution of 
the function requested by the 
order has not yet been 
completed. 

b. A manual-reset function has 
been initiated at the addressed 
CPU, and the function has not 
yet been completed. This 
condition cannot arise as a 
result of a SIGNAL PROCESSOR by 
a CPU addressing itself. 
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I 



If the currently specified order is 
sense, external call, emergency 
signal, start, stop, restart, stop 
and store status, set prefix, or 
store status at address, then the 
order is rejected, and condition 
code 2 is set. If the currently 
specified order is one of the reset 
orders, or an unassigned or not- 
implemented order, either the order 
is rejected and condition code 2 is 
set or the order code is interpret- 
ed as described in the section 
"Status Bits" in this chapter. 
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When the conditions described in items 1 
and 2 above do not apply and operator- 
intervening and receiver-check status 
conditions do not exist at the addressed 
CPU, reset orders may be accepted 
regardless of whether the addressed CPU 
has completed a previously accepted 
order. This may cause the previous 
order to be lost when it is only 
partially completed, making unpredict- 
able whether the results defined for the 
lost order are obtained. 



Status Bits 



Various status conditions are defined 
whereby the issuing and addressed CPUs 
can indicate their responses to the 
specified order. The status conditions 
and their bit positions in the general 
register designated by the R t field of 
the SIGNAL PROCESSOR instruction are 
shown in the figure "Status Conditions." 



Bit 




Posi tion 


Status Condition 





Equipment check 


1-21 


Unassigned; zeros stored 


22 


Incorrect state 


23 


Invalid parameter 


24 


External-call pending 


25 


Stopped 


26 


Operator intervening 


27 


Check stop 


28 


Unassigned; zero stored 


29 


Inoperati ve 


30 


Invalid order 


31 


Receiver check 



I 



Status Conditions 



The status condition assigned to bit 
position is generated by the CPU 
executing SIGNAL PROCESSOR. The remain- 
ing status conditions are generated by 
the addressed CPU. 

When the equipment-check condition 
exists, bit of the general register 
designated by the R, field of the SIGNAL 
PROCESSOR instruction is set to one, 
unassigned bits of the status register 
are set to zeros, and the contents of 
other status bits are unpredictable. In 
this case, condition code 1 is set inde- 
pendent of whether the access path to 
the addressed CPU is busy and independ- 
ent of whether the addressed CPU is not 
operational, is busy, or has presented 
zero status. 

When the access path to the addressed 
CPU is not busy and the addressed CPU is 
operational and does not indicate busy 
to the currently specified order, the 
addressed CPU presents its status to the 
issuing CPU. These status bits are of 
two types: 

1. Status bits 22-27 and 29 indicate 
the presence of the corresponding 
conditions in the addressed CPU at 
the time the order code is 
received. Except in response to 
the sense order, each condition is 
indicated only when the condition 
precludes the successful execution 
of the specified order, although 
invalid parameter is not necessai — 
i ly indicated when any other 
precluding condition exists. In 
the case of sense, all existing 
status conditions are indicated; 
the operatoi — intervening condition 
is indicated if it precludes the 
execution of any installed order. 

2. Status bits 30 and 31 indicate that 
the corresponding conditions were 
detected by the addressed CPU 
during reception of the order. 

If the presented status is all zeros, 
the addressed CPU has accepted the 
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order* and condition code is set at 
the issuing CPU; if the presented status 
is not all zeros* the order has been 
rejected* the status is stored at the 
issuing CPU in the general register 
designated by the R, field of the SIGNAL 
PROCESSOR instruction, zeros are stored 
in the unassigned bit positions of the 
register, and condition code 1 is set. 



The status 
follows: 



conditions are defined as 



Equipment Check : This condition exists 
when the CPU executing the instruction 
detects equipment malfunctioning that 
has affected only the execution of this 
instruction and the associated order. 
The order code may or may not have been 
transmitted and may or may not have been 
accepted, and the status bits provided 
by the addressed CPU may be in error. 

Incorrect State : A set-prefix or 
store-status-at-address order has been 
rejected because the addressed CPU is 
not stopped. When applicable, this 
status is generated during execution of 
SIGNAL PROCESSOR and is indicated 
concurrently with other indications of 
conditions which preclude execution of 
the order. 

Invali d Parameter : The parameter value 
supplied with a set-prefix or store- 
status-at-address order designates a 
storage location which is not available 
in the configuration. When applicable, 
this status is generated during 
execution of SIGNAL PROCESSOR, except 
that it is not necessarily generated 
when another condition precluding 
execution of the order also exists. 

External Call Pending : This condition 
exists when an external-call inter- 
ruption condition is pending in the 
addressed CPU because of a previously 
issued SIGNAL PROCESSOR order. The 
condition exists from the time an 
external-call order is accepted until 
the resultant external interruption has 
been completed or a CPU reset occurs. 
The condition may be due to the issuing 
CPU or another CPU. The condition, when 
present, is indicated only in response 
to sense and to external call. 

Stopped : This condition exists when the 
addressed CPU is in the stopped state. 
The condition, when present, is indi- 
cated only in response to sense. This 
condition cannot be reported as a result 
of a SIGNAL PROCESSOR by a CPU address- 
ing itself. 

Operator Interveni ng : This condition 
exists when the addressed CPU is execut- 
ing certain operations initiated from 
local or remote operator facilities. 



The particular manually initiated opei — 
ations that cause this condition to be 
present depend on the model and on the 
order specified. The operator- 
intervening condition may exist when the 
addressed CPU uses reloadable control 
storage to perform an order and the 
required microprogram is not loaded. 
The operatoi — intervening condition, when 
present, can be indicated in response to 
all orders. Operator intervening is 
indicated in response to sense if the 
condition is present and precludes the 
acceptance of any of the installed 
orders. The condition may also be indi- 
cated in response to unassigned or 
uninstalled orders. This condition 
cannot arise as a result of a SIGNAL 
PROCESSOR by a CPU addressing itself. 

Check Stop : This condition exists when 
the addressed CPU is in the check-stop 
state. The condition, when present, is 
indicated only in response to sense, 
external call, emergency signal, start, 
stop, restart, set prefix, store status 
at address, and stop and store status. 
The condition may also be indicated in 
response to unassigned or uninstalled 
orders. This condition cannot be 
reported as a result of a SIGNAL PROCES- 
SOR by a CPU addressing itself. 

Inoperati ve : This condition indicates 
that the execution of the operation 
specified by the order code requires the 
use of a service processor which is 
inoperative. The failure of the service 
processor may have been previously 
reported by a servi ce-processoi — damage 
machine-check condition. The inopera- 
tive condition cannot occur for the 
sense, external-call, or emergency- 
signal order code. 

Invalid Order : This condition exists 
during the communications associated 
with the execution of SIGNAL PROCESSOR 
when an unassigned or uninstalled order 
code is decoded. 

Receiver Check : This condition exists 
when the addressed CPU detects malfunc- 
tioning of equipment during the communi- 
cations associated with the execution of 
SIGNAL PROCESSOR. When this condition 
is indicated, the order has not been 
initiated, and, since the malfunction 
may have affected the generation of the 
remaining receiver status bits, these 
bits are not necessarily valid. A 
machine-check condition may or may not 
have been generated at the addressed 
CPU. 

The following chart summarizes which 
status conditions are presented to the 
issuing CPU in response to each order 
code. 
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Status Condi ti on 



Programmi ng Notes 



| 



31 Receiver check* 

30 Invalid order 

29 Inoperative 

27 Check stop 

26 Operator intervening** 

25 Stopped 

24 External call pending 

23 Invalid parameter 

22 Incorrect state 
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Order 

Sense 

External call 

Emergency signal 

Start 

Stop 

Restart 

Stop and store status 

Initial CPU reset 

CPU reset 

Set prefix 

Store status at addr. 

Unassigned order 



Explanation : 

t If a one is presented in the 
receivei — check bit position, the 
values presented in the other bit 
positions are not necessarily 
vali d. 

tt The current state of the operator- 
intervening condition may depend on 
the order code that is being intei — 
preted. 

A zero is presented in this bit 
position regardless of the current 
state of this condition. 



A one i s presented 
posi ti on. 



i n thi s bit 



A zero or a one is presented in 
this bit position, reflecting the 

current state of the corresponding 
condi ti on. 

Either a zero or the current state 

of the corresponding condition is 
i ndi cated. 



If the presented status bits are all 
zeros, the order has been accepted, and 
the issuing CPU sets condition code 0. 
If one or more ones are presented, the 
order has been rejected, and the issuing 
CPU stores the status in the general 
register designated by the R t field of 
the SIGNAL PROCESSOR instruction and 
sets condition code 1. 



All SIGNAL PROCESSOR orders can be 
addressed to this same CPU. The 
following are examples of functions 
obtained by a CPU addressing SIGNAL 
PROCESSOR to itself: 



a. 



d. 



e. 



f. 



Sense indicates whether an 
external-call condition is 
pendi ng. 

External call and emergency 
si gnal cause the corresponding 
interruption conditions to be 
generated. External call can 
be rejected because of a previ- 
ously generated external-call 
condi ti on. 

Start sets condition code and 
has no other effect. 

Stop causes the CPU to set 
condition code 0, take pending 
interruptions for which it is 
enabled, and enter the stopped 
state. 



Restart provides a means 
store the current PSW. 



to 



Stop and store status causes 
the machine to stop and store 
all current status. 



Two CPUs can simultaneously execute 
SIGNAL PROCESSOR, with each CPU 
addressing the other. When this 
occurs, one CPU, but not both, can 
find the access path busy because 
of the transmission of the order 
code or status bits associated with 
SIGNAL PROCESSOR that is being 
executed by the other CPU. Alter- 
natively, both CPUs can find the 
access path available and transmit 
the order codes to each other. In 
particular, two CPUs can simultane- 
ously stop, restart, or reset each 
other. 

To obtain status from another CPU 
which is in the check-stop state by 
means of the store-status-at- 
address order, a CPU reset opera- 
tion should first be used to bring 
the CPU to the stopped state. This 
reset order does not alter the 
status, and, depending on the 
nature of the malfunction, provides 
the best chance of establishing 
conditions in the addressed CPU 
which allow status to be obtained. 
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Normally, operation of the CPU is 
controlled by instructions in storage 
that are executed sequentially, one at a 
time, left to right in an ascending 
sequence of storage addresses. A change 
in the sequential operation may be 
caused by branching, LOAD PSW, inter- 
ruptions, SIGNAL PROCESSOR orders, or 
manual intervention. 



INSTRUCTIONS 



Each instruction consists of two major 
parts: 

* An operation code (op code), which 
specifies the operation to be 
performed 

• The designation of the operands 
that participate 



OPERANDS 



Operands can be grouped in three 
classes: operands located in registers, 
immediate operands, and operands in 
storage. Operands may be either explic- 
itly or implicitly designated. 



Register operands can 
general, floating-point 
registers, with the typ 
identified by the op code 
containing the operand i 
identifying the register 
field, called the R 
instruction. For some i 
operand is located in 
designated register, the 
implied by the op code. 



be located in 

, or control 

e of register 

The register 

s specified by 

in a four-bit 

field, in the 

nstructions, an 

an implicitly 

register being 



Immediate operands are contained within 
the instruction, and the eight-bit field 
containing the immediate operand is 
called the I field. 



Operand 

length; 

speci f i 

length 

field, 

length 

general 

operand 

means o 



s in stora 
be speci 

ed by a 
speci f ica 
i n the i 

speci f i ed 
regi ster 

s in sto 

f a format 



ge may have an implied 
fied by a bit mask; be 
foui — bit or eight-bit 
tion, called the L 
nstruction; or have a 

by the contents of a 

The addresses of 

rage are specified by 

that uses the contents 



of a general register as part of the 
address. This makes it possible to: 

1. Specify a complete address by using 
an abbreviated notation 

2. Perform address manipulation using 
instructions which employ general 
registers for operands 

3. Modify addresses by program means 
without alteration of the instruc- 
tion stream 

4. Operate independent of the location 
of data areas by directly using 
addresses received from other 
programs 

The address used to refer to storage 
either is contained in a register desig- 
nated by the R field in the instruction 
or is calculated from a 
index, and displacement, 
the B, X, and D fields, 
the instruction. 



base address, 
specified by 
respectively, in 



To describe the execution of 
instructions, operands are designated as 
first and second operands and, in some 
cases, third operands. 

In general, two operands participate in 
an instruction execution, and the result 
replaces the first operand. However, 
CONVERT TO DECIMAL, TEST BLOCK, and 
instructions with "store" in the 
instruction name (other than STORE THEN 
AND SYSTEM MASK and STORE THEN OR SYSTEM 
MASK) use the second-operand address to 
designate a location in which to store. 
TEST AND SET, COMPARE AND SWAP, and 
AND SWAP may perform an 
second operand. Except 
stated, the contents of 
and storage locations 
in the addressing or 
of an operation remain 



COMPARE DOUBLE 
update on the 
when otherwise 
all registers 
parti ci pati ng 
execution part 
unchanged. 



INSTRUCTION FORMAT 



An instruction is one, two, or three 
half words in length and must be located 
in storage on a halfword boundary. Each 
instruction is in one of nine basic 
formats: E, RR, RRE, RX, RS, SI, S, 
SSE, and SS, with two variations of SS. 
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(See the figure "Basic 
Formats.") 



Instruct! on 



Some instructions contain fields that 
vary slightly from the basic format, and 
in some instructions the operation 
performed does not follow the general 
rules stated in this section. All of 
these exceptions are explicitly identi- 
fied in the individual instruction 
descripti ons. 

Those instruction formats which are 
unique to instructions associated with 
the vector facility are described in the 
publication IBM System/370 Vector Opet — 
ations , SA22-7125. 

The format names indicate, in general 
terms, the classes of operands which 
participate in the operation: 



E denotes an operation using 
implied operands and having an 
extended op-code field. 

RR denotes a regi ster-and-regi ster 
operation. 

RRE denotes a regi ster-and-regi ster 
operation having an extended 
op-code field. 

RX denotes a registei — and-indexed- 
storage operation. 

RS denotes a registei — and-storage 
operati on. 

SI denotes a storage-and-immediate 
operati on. 

S denotes an operation using an 
implied operand and storage. 

SS denotes a storage-and-storage 
operati on . 

SSE denotes a storage-and-storage 
operation having an extended 
op-code field. 



E Format 



Op Code 



15 



RR Format 



Op Code 


Ri 


R 2 



8 12 15 



RRE Format 



Op Code 


//////// 


Ri 


R 2 



16 



24 28 31 



RX Format 



Op Code 


Ri 


x a 


B, 


D a 



8 12 16 20 



31 



RS Format 



Op Code 


Rt 


Ra 


B 2 


D a 



8 12 16 20 



31 



SI Format 



Op Code 


la 


B, 


D, 



16 20 



31 



S Format 



Op Code 


B a 


D a 



16 20 



31 



SS Format 



Op Code 



B, 



D, 
-/- 



16 20 32 36 47 



Op Code 



L, 



B, 



D, 



/ 

2 Da 
L—/ 1 

47 





8 12 16 20 32 36 47 



Op Code 



Ri 



B, 



-/- 



$n 



8 12 



16 



20 



32 36 47 



SSE Format 



Op Code 



B t 



D t 
-/— 



B 



■/ I 



16 20 32 36 47 

Basic Instruction Formats 



The first byte or, in the E, RRE, S, and 
SSE formats, the first two bytes of an 
instruction contain the op code. For 
some instructions in the S format, all 
or a portion of the second byte is 
ignored. 

The first two bits of the first or only 
byte of the op code specify the length 
and format of the instruction, as 
follows: 
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Bit 

Posi ti ons 

0-1 


Instruction 
Length (in 
Halfwords) 


Instruction 
Format 


00 
01 
10 
11 


One 

Two 

Two 

Three 


E/RR 
RX 
RRE/R5/RX/S/SI 
SS/SSE 



In the format illustration for each 
individual instruction description, the 
op-code field shows the op code as hexa- 
decimal digits within single quotes. 
The hexadecimal representation uses 0-9 
for the binary codes 0000-1001 and A-F 
for the binary codes 1010-1111. 

The remaining fields in the format 
illustration for each instruction are 
designated by code names, consisting of 
a letter and possibly a subscript 
number. The subscript number denotes 
the operand to which the field applies. 



Regi ster Operands 



In the RR, RRE, RX, and RS formats, the 
contents of the register designated by 
the Ri field are called the first opei — 
and. The register containing the first 
operand is sometimes referred to as the 
"first-operand location," and sometimes 
as "register R t ." In the RR and RRE 
formats, the R 2 field designates the 
register containing the second operand, 
and the R a field may designate the same 
register as R t . In the RS format, the 
use of the R 3 field depends on the 
instructi on. 

The R field designates a general regis- 
ter in the general and control 
instructions and a floating-point regis- 
ter in the floating-point instructions. 
In the instructions LOAD CONTROL and 
STORE CONTROL, the R field designates a 
control register. 

Unless otherwise indicated in the indi- 
vidual instruction description, the 
register operand is one register in 
length (32 bits for a general register 
or a control register and 64 bits for a 
floating-point register), and the second 
operand is the same length as the first. 



Immediate Operands 



In the SI format, the contents of the 
eight-bit immediate-data field, the I 2 
field of the instruction, are used 
directly as the second operand. The B t 
and D t fields specify the first operand, 
which is one byte in length. 



Storage Operands 



In the SI, SSE, and SS formats, the 
contents of the general register desig- 
nated by the B t field are added to the 
contents of the D t field to form the 
first-operand address. In the S, RS, 
SSE, and SS formats, the contents of the 
general register designated by the B 2 
field are added to the contents of the 
D 2 field to form the second-operand 
address. In the RX format, the contents 
of the general registers designated by 
the X 2 and B 2 fields are added to the 
contents of the D 2 field to form the 
second-operand address. 

In the SS format with a single, 
eight-bit length field, L specifies the 
number of additional operand bytes to 
the right of the byte designated by the 
first-operand address. Therefore, the 
length in bytes of the first operand is 
1-256, corresponding to a length code in 
L of 0-255. Storage results replace the 
first operand and are never stored 
outside the field specified by the 
address and length. In this format, the 
second operand has the same length as 
the first operand, except for the 
following instructions: EDIT, EDIT AND 
MARK, TRANSLATE, and TRANSLATE AND TEST. 

In the SS format, with two length fields 
given, Li specifies the number of addi- 
tional operand bytes to the right of the 
byte designated by the first-operand 
address. Therefore, the length in bytes 
of the first operand is 1-16, corre- 
sponding to a length code in L t of 0-15. 
Similarly, L 2 specifies the number of 
additional operand bytes to the right of 
the location designated by the second- 
operand address. Results replace the 
first operand and are never stored 
outside the field specified by the 
address and length. If the first opei — 
and is longer than the second, the 
second operand i s extended on the left 
with zeros up to the length of the first 
operand. This extension does not modify 
the second operand in storage. 

In the SS format with two R fields, the 
contents of the general register speci- 
fied by the R, field are a 32-bit 
unsigned value called the true length. 
The operands are of the same length, 
called the effective length. The effec- 
tive length is equal to the true length 
or 256, whichever is less. The 
instructions using this format, which 
are MOVE TO PRIMARY, MOVE TO SECONDARY, 
and MOVE WITH KEY, set the condition 
code to facilitate programming a loop to 
move the total number of bytes specified 
by the true length. 
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ADDRESS GENERATION 



OPERAND-ADDRESS GENERATION 



Formati on of the Intermediate Value 



BIMODAL ADDRESSING 



Bit 32 of the current PSW is the 
addressing-mode bit. This bit controls 
the size of the effective address 
produced by address generation. When 
bit 32 of the current PSW is zero* the 
CPU is in the 24-bit addressing mode, 
and 24-bit instruction and operand 
effective addresses are generated. When 
bit 32 of the current PSW is one, the 
CPU is in the 31-bit addressing mode, 
and 31-bit instruction and operand 
effective addresses are generated. 



Execution of instructions 
involves generation of the 
instructions and operands, 
describes address genera 
applies to most instructio 
instructions, the operati 
does not follow the general 
in this section. All 
exceptions are explicitly 
the individual instruction 
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SEQUENTIAL INSTRUCTION-ADDRESS GENER- 
ATION 



When an instruction is 
location designated by 
the instruction addres 
the number of bytes i 
and the instruction 
same steps are then 
the new value of the i 
to fetch the next i 
sequence. 



fetched from the 
the current PSW, 
s is increased by 
n the instruction, 
is executed. The 
repeated by using 
nstruction address 
nstruction in the 



In the 24-bit addressing mode, instruc- 
tion addresses wrap around, with the 
halfword at instruction address 2 24 - 2 
being followed by the halfword at 
instruction address 0. Thus, in the 
24-bit addressing mode, any carry out of 
PSW bit position 40, as a result of 
updating the instruction address, is 
lost. 

In the 31-bit addressing mode, instruc- 
tion addresses wrap around, with the 
halfword at instruction address 2 31 - 2 
being followed by the halfword at 
instruction address 0. Thus, in the 
31-bit addressing mode, any carry out of 
PSW bit position 33, as a result of 
updating the instruction address, is 
lost. 



An operand address that refers to stor- 
age is derived from an intermediate 
value, which either is contained in a 
register designated by an R field in the 
instruction or is calculated from the 
sum of three binary numbers: base 
address, index, and displacement. 

The base address (B) is a 32-bit number 
contained in a general register speci- 
fied by the program in a four-bit field, 
called the B field, in the instruction. 
Base addresses can be used as a means of 
independently addressing each program 
and data area. In array-type calcu- 
lations, it can designate the location 
of an array, and, in record-type proc- 
essing, it can identify the record. The 
base address provides for addressing the 
entire storage. The base address may 
also be used for indexing. 



The index (X) 
contained in a 
nated by the 
field, called 
instruction. It 
address specif i 
instructions, 
tions permit do 
the index can 
address of an el 



is a 32-bi 
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t number 
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The displacement (D) is 
contained in a field, 
field, in 
di splacement 
addressing of 
the location 
address. In 



a 12-bit number 

called the D 

the instruction. The 

provides for relative 

up to 4,095 bytes beyond 

designated by the base 

_ array-type calculations, 

the displacement can be used to specify 
one of many items associated with an 
element. In the processing of records, 
the displacement can be used to identify 
items within a record. 

In forming the intermediate sum, the 
base address and index are treated as 
32-bit binary integers. The displace- 
ment is similarly treated as a 12-bit 
unsigned binary integer, and 20 zeros 
are appended on the left. The three are 
added as 32-bit binary numbers, ignoring 
overflow. The sum is always 32 bits 
long and is used as an intermediate 
value to form the generated address. 
The bits of the intermediate value are 
numbered 0-31. 

A zero in any of the B t , B a , or X a 
fields indicates the absence of the 
corresponding address component. For 
the absent component, a zero is used in 
forming the intermediate sum, regardless 
of the contents of general register 0. 
A displacement of zero has no special 
si gnif i cance. 
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When an instruction description speci- 
fies that the contents of a general 
register designated by an R field are 
used to address an operand in storage, 
the register contents are used as the 
32-bit intermediate value. 

An instruction can designate the same 
general register both for address compu- 
tation and as the location of an 
operand. Address computation is 
completed before registers, if any, are 
changed by the operation. 

Unless otherwise indicated in an indi- 
vidual instruction definition, the 
generated operand address designates the 
leftmost byte of an operand in storage. 



Formati on of the Address 



The generated operand address is always 
31 bits long, and the bits are numbered 
1-31. In some portions of this 
document, the generated address may be 
referred to as being 32 bits long, with 
the bits numbered 0-31. Bit of the 
generated address is always forced to be 
zero. The manner in which the generated 
address is obtained from the intermedi- 
ate value depends on the current 
addressing mode. In the 24-bit address- 
ing mode, bits 0-7 of the intermediate 
value are ignored, bits 0-7 of the 
generated address are forced to be 
zeros, and bits 8-31 of the intermediate 
value become bits 8-31 of the generated 
address. In the 31-bit addressing mode, 
bit of the intermediate value is 
ignored, bit of the generated address 
is forced to be zero, and bits 1-31 of 
the intermediate value become bits 1-31 
of the generated address. 



Programming Note 



Negative values may be used in index and 
base-address registers. Bit of these 
values is always ignored, and, in the 
24-bit addressing mode, bits 1-7 of 
these values are also ignored. 



BRANCH-ADDRESS GENERATION 



For branch instructions, the address of 
the next instruction to be executed when 
the branch is taken is called the branch 
address. Depending on the branch 
instruction, the instruction format may 
be RR, RS, or RX. 

In the RS and RX formats, the branch 
address is specified by a base address, 
a displacement, and, for RX, an index. 
In the RS and RX formats, the branch 



address generation follows the normal 
rules for operand-address generation. 

In the RR format, the contents of the 
general register designated by the R 2 
field are used as the intermediate value 
from which the branch address is formed. 
General register cannot be designated 
as containing a branch address. A value 
of zero in the R 2 field causes the 
instruction to be executed without 
branchi ng. 



Formation of the Branch Address 



The branch address is always 31 bits 
long, with the bits numbered 1-31. The 
branch address replaces bits 33-63 of 
the current PSW. The manner in which 
the branch address is obtained from the 
intermediate value depends on the 
addressing mode. For those branch 
instructions which change the addressing 
mode, the new addressing mode is used. 
In the 24-bit addressing mode, bits 1-7 
of the intermediate value are ignored, 
bits 1-7 of the branch address are made 
zeros, and bits 8-31 of the intermediate 
value become bits 8-31 of the branch 
address. In the 31-bi t "addressi ng mode, 
bit of the intermediate value is 
ignored, and bits 1-31 of the intermedi- 
ate value become bits 1-31 of the branch 
address. 



For several branch instruct 
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satisfied, the branch is 
normal sequential instruct 
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A specification exception due to an odd 
branch address and access exceptions due 
to fetching of the instruction at the 
branch location are not recognized as 
part of the branch operation but instead 
are recognized as exceptions associated 
with the execution of the instruction at 
the branch location. 

A branch instruction, such as BRANCH AND 
LINK, can designate the same general 
register for branch-address computation 
and as the location of an operand. 
Branch-address computation is completed 
before the remainder of the operation is 
executed. 



INSTRUCTION EXECUTION AND SEQUENCING 



The program-status word (PSW), described 
in Chapter 4, "Control," contains infor- 
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(nation required for proper program 
execution. The PSW is used to control 
instruction sequencing and to hold and 
indicate the status of the CPU in 
relation to the program currently being 
executed. The active or controlling PSW 
is called the current PSW. 

Branch instructions perform the func- 
tions of decision making, loop control, 
and subroutine linkage. A branch 
instruction affects instruction sequenc- 
ing by introducing a new instruction 
address into the current PSW. 



DECISION MAKING 



Facilities for decision making are 
provided by BRANCH ON CONDITION. This 
instruction inspects a condition code 
that reflects the result of a majority 
of the arithmetic, logical, and I/O 
operations. The condition code, which 
consists of two bits, provides for four, 
possible condition-code settings: 0, 1, 
2, and 3. 



The specific meaning of 
depends on the operation 
condition code. For examp 
tion code reflects such 
zero, nonzero, first o 
equal, overflow, and sub 
Once set, the condition 
unchanged until modified 
tion that causes a diffe 
code to be set. See 
"Condition-Code Settings," 
of the instructions which 
tion code. 



LOOP CONTROL 



any setting 
that sets the 
le, the condi- 
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perand high, 
channel busy. 
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rent condition 

Appendix C, 

for a summary 
set the condi- 



Loop control can be performed by the use 
of BRANCH ON CONDITION to test the 
outcome of address arithmetic and count- 
ing operations. For some particularly 
frequent combinations of arithmetic and 
tests, BRANCH ON COUNT, BRANCH ON INDEX 
HIGH, and BRANCH ON INDEX LOW OR EQUAL 
are provided. These branches, being 
specialized, provide increased perform- 
ance for these tasks. 



SUBROUTINE LINKAGE 



Subroutine linkage is provided by the 
BRANCH AND LINK and BRANCH AND SAVE 
instructions, which permit not only the 
introduction of a new instruction 
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The instructions PROGRAM CALL and 
PROGRAM TRANSFER provide the facility 
for linkage between programs of diffei — 
ent authority and in different address 
spaces. PROGRAM CALL permits linkage to 
a number of preassigned programs that 
may be in either the problem or the 
supervisor state and may be in either 
the same address space or an address 
space different from that of the caller. 
In general, it is used to transfer 
control to a program of higher 
authority. PROGRAM TRANSFER permits a 
change of the instruction address, 
addressing mode, and address space. 
PROGRAM TRANSFER also permits a 
reduction in PSW-key-mask authority and 
a change from the supervisor to the 
problem state. In general, it is used 
to transfer control from one program to 
another of equal or lower authority. 
PROGRAM TRANSFER can be used to return 
from a program called by PROGRAM CALL. 

The operation of PROGRAM CALL is 
controlled by means of an entry-table 
entry, which is located as part of a 
table-lookup process during the 
execution of the instruction. The 
instruction causes the primary address 
space to be changed only when the ASN in 
the entry-table entry is nonzero. When 
the primary address space is changed, 
the operation is called PROGRAM CALL 
with space switching (PC-ss). When the 
primary address space is not changed, 
the operation is called PROGRAM CALL to 
current primary (PC-cp). 

PROGRAM TRANSFER specifies the new 
addressing mode and the address space 
which is to become the new primary 
address space. When the primary address 
space is changed, the operation is 
called PROGRAM TRANSFER with space 
switching (PT-ss). When the primary 
address space is not changed, the opera- 
tion is called PROGRAM TRANSFER to 
current primary (PT-cp). 

The linkage instructions provided and 
the functions performed by each are 
summarized in the figure "Linkage- 
Instruction Summary." 



f 
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Instruction 


Format 


Instruction 

Address 

PSW Bits 33-63 


Addressing 

Mode 
PSW Bit 32 


Problem 

State 

PSW Bit 15 


PASN 

CR4 

Bits 16-31 


PSW-Key 

Mask 
Changed 
in CR3 


Trace 


Save 


Set 


Save 


Set 


Save 


Set 


Save 


Set 


BALR* 


RR 


Yes 


Ra 1 


AM 


- 


- 


- 


- 


- 


- 


Ra 1 


BALK 


RX 


Yes 


Yes 


AM 


- 


- 


- 


- 


- 


- 


- 


BASR 


RR 


Yes 


Ra 1 


Yes 


- 


- 


- 


- 


- 


- 


Ra 1 


BAS 


RX 


Yes 


Yes 


Yes 


- 


- 


- 


- 


- 


- 


- 


BASSM 


RR 


Yes 


Ra 1 


Yes 


Ra 1 


- 


- 


- 


- 


- 


Ra 1 


BSM X 


RR 


- 


Ra 1 


R, 1 


R» l 


- 


- 


- 


- 


- 


- 


MC* 2 ^^ 


SI 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


- 


- 


- 


- 


PC-cp 


S 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


- 


- 


"OR" EKM 


Yes 


PC-ss 


S 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


"OR" EKM 


Yes 


PT-cp 


RRE 


- 


R a 


- 


Ra 


- 


R 2 xx 


- 


- 


"AND" R, 


Yes 


PT-ss 


RRE 


- 


Ra 


- 


R a 


- 


RjXX 


- 


Yes 


"AND" R, 


Yes 


SVC 2 


RR 


Yes 


Yes 1 Yes 


Yes 


Yes 


Yes 


- 


- 


- 


- 


Explanation: 








No 

x In the 24-b 
and 24-bit 
the 31-bit 
saved, and 


it addressing mode, the instruction-length code, condition code, program mask, 
instruction address are saved, and the 24-bit instruction address is set; in 
addressing mode, the addressing mode and the 31-bit instruction address are 
the 31-bit instruction address is set. 


XX A change from the supervisor to the problem state is allowed; a privileged-operation excep- 
tion is recognized when a change from the problem to the supervisor state is specified. 


8 Monitor-mas 


k bits provide a means of disallowing linkage, or enabling linka 


ge, for selected 


classes of 


events. 






1 The action 


takes place only if the associated R field in the instruction is 


nonzero. 




2 MC and SVC, 


as part of the interruption, save the entire current PSW and load a new PSW. 


AM Saved only 


if the 31-bit addressing mode is specified. 







Linkage-Instruction Summary 



Programming Note 



To give the reader a better understand- 
ing of the utility and intended usage of 
the linkage instructions, the following 
paragraphs in this note describe various 
program linkages and conventions and the 
use of the linkage instructions in these 
si tuations. 

The linkage instructions are provided to 
permit System/370 programs to operate 
with no modification or only slight 
modification on systems operating in the 
370-XA mode and also to provide addi- 
tional function for those programs which 
sre designed to take advantage of opera- 
tion in the 370-XA mode. The 
instructions provide the capability for 
both old and new programs to coexist in 
storage and to communicate with each 
other. It is assumed that old, unmodi- 
fied programs operate in the 24-bit 
addressing mode and call, or directly 



communicate with, other p 
ing in the 24-bit addres 
Modified programs normal 
the 24-bit addressing mod 
programs which operate 
24-bit or 31-bit address 
programs may be written 
either the 24-bit or 31 
mode, and in some cases a 
written such that it can 
either mode. 



rograms operat- 

sing mode only. 

ly operate in 

e but may call 

in either the 

ing mode. New 

to operate in 

-bit addressing 

program may be 

be invoked in 



sitPFPUT^np tai i ... in provided for compat- 
ibility purposes and also because it 
provides the simplest mechanism to call 
g-TSEagramjdh Tch operates in the supervi- 
SQjL^S.tai.e-. it has the advantage over 
PROGRAM CALL that no general registers 
are disturbed, that only two bytes in 
storage are required in line, and that a 
complete change of PSW status is 
provided. Tho r.ffiliurP- from a routine 
called by SUPdWISOR CALL normally is 

accojxpJJ sh.ejd.by means of 1 PAD PSW. whirl* 

is a pri vi leged instruction. 
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) 



PROGRAM CALL 




i ndex 

space 

than 

The 



jj^, even to a program with 

the same aut hgrity. PROGRAM CALL 
permi ts a programto call a program 
operating in a different address space. 
This would normally be used in the situ- 
ation where the authorization 
associated with the called address 
had a higher level of authority 
that of the calling address space 
advantage of PROGRAM CALL over SUPERVI- 
SOR CALL is in speed, since first- and 
second-level i nterrupti on-handler 
programs are avoided. It also provides 
a possible 2 20 different entry points. 
The authorization key mask in the 
entry-table entry permits a particular 
entry point to be available to a limited 
subset of the programs in the system. 
Thus, some or all of the authority 
checking which would otherwise have to 
be placed in the called program can be 

eliminated. R,£„tM JLH ■.■., if £ {? ffl a routine 

called by PR C IGRAM^CfflTL is n ormal 1 
accomplished by means of the PkujGRI 

TRANSFER instruction; hn HO wor r | q/ip .p«;u 



may^pe^ u sed 1 f the ca. 

the super vTso r state. 



the 



PROGRAM TRANSFER. is provided as the 
return instru ct ion for PROG RAM CALL. It 
is also useful for calling or trans- 
ferring to programs with the same 
authority in another address space. 
Although PROGRAM TRANSFER does not save 
the current PASN, the instruction 
EXTRACT PRIMARY ASN may be used to 
provide the PASN for return -purposes. 

BRANCH AND SAVE AND SET MODE (BASSM) is 
intended to be the principal calling 
instruction to subroutines outside of an 
assembler/linkage-editor control section 
(CSECT), for use by all new programs. 
BRANCH AND SET MODE (B.SMJL is intended to 
be t h e 'l__r.eJEirFrr* M [ n is j: r ucn ^u's e cj'" "aTt'e r a 



TFisassumeSf 
ToHffie current V-typ 
(VCON) will be establ 
bier and linkage edi 
of a 31-bit entry-po 
leftmost bit indica 
entry is in the 
addressing mode. Thi 
shown here as "VCON 
sequence would normal 



tTia^^a^T^exTen s 1 o n 
e address constant 
i shed by the assem- 
tor which consists 
int address and a 
ting whether the 
24-bit or 31-bit 
s extended VCON is 
E." This calling 
ly be: 



L 15,VC0NE 
BASSM 14,15 



The return from 
normally be: 



BSM 



0,14 



such a routine would 



BALR) instruc- 



The .BRANCH ANDLINK (BAL, 

tion i s" r ^ 1 ro^*f!'9^r^i i marJ.l.y, ...J^oXwQmp^t- 

i bili ty.. __7^ asojr^^ defined to 

oTJeraTei n ^he™*3T-b i t addressing mode to 
increase the probability that an old, 
straightforward program can be modified 
to operate in the 31-bit addressing mode 



with minimal or no change. It i s recomr- 
mendeji, however, that BRANCH AND SAVE 
TBAS and BASR) be used i nstead and, that 

BRANCH Am -VIM" be avoXripri .qijxcjL.il: 

eJajp^^aariseoL — i,n.fnxnifltiQa,.i.n — ths~±&£L. 
p art o f the general register i n the 

"Z 4 - b i t ""a dcTr ess 1 n g m'ocl'e , w h 1 c h may lead 

to problems. Additionally, BRANCH AND 
LINK is likely to be slower than BRANCH 
AND SAVE because BRANCH AND SAVE always 
saves the right half of the PSW, whereas 
BRANCH AND LINK must take additional 
time to check the addressing mode, and 
then even more time, if in the 24-bit 
addressing mode, to construct the ILC, 
condition code, and program mask to be 
placed in the leftmost byte of the link 
register. 

It is assumed that t hg_ , go r.ma k.^alurja~ 
fron « a subro utine called bv BRANCH AND. 

rnnrTBAL'o? BATirrwTrrTeT^ 

BCJR_JJ^JL4_. 

m ■"""■ 

However, the standard "return 



"tr 



on 



1rrr 



i nstruc- 



BSM 0,14 



o perates ,fi.o KX&9& ,1 Y, f 9 r ^..a-LL-ca se« 



fo r a -jdJ JUllja^Q^ 
addressing mode. In the 24-bit address- 
ing mode, BAL causes an ILC of 10 to be 
placed in the leftmost two bits of the 
link register. Thus, a BSM would return 
in the 31-bit addressing mode. Note 
that an EXECUTE of BALR in the 24-bit 
addressing mode also causes the same ILC 
effect. 



The B^AJCJi^AJiP^SMI^iMS^ 
tion is provided 



JLkSJLl, instruc- 
used for subrou- 



to ifin be ._ 




.tjo.Jb^Jji 
with the 



jCJ^ojr^^Jkrtowji, 
LSJJiajaajda. BASR 
also useful for obtaining 
addressability to the instruction stream 
by getting a 31-bit address, uncluttered 
by leftmost fields, in the 24-bit 
addressing mode. B RANCH AND SAME (BAS, 
BASR) is the fastest 1 L^ 
since the linkage information is not 
addressing-mode sensitive and since the 
instruction does not change the address- 
ing mode. 



The return instruction from a ro utin e 
ca 1 1 e- d'l? y - ^R A K C^nrNTJn S A VE ( B AT^o TnSI^T 
Toay^TSe" e it her™** 



BCR 



15,14 



or 



BSM 0,14 



In some cases, it may 
rewrite a program that 
old program which 
rewritten. In such a 
program, which operates 
addressing mode, will 



be desirable to 

is called by an 

has not been 

case, the old 

in the 24-bit 

be given the 



address of an intermediate program that 
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will set up the correct entry and return 
modes and then call the rewritten 
program. Such a program is sometimes 
referred to as a glue module . The 
instruction BRANCH AND SET MODE (BSM) 
with a nonzero Ri field provides the 
function necessary to perform this oper — 
ation efficiently. This is shown in the 
figure "Glue Module." 



Note that the "BSM 14,15" in the glue 
module causes the addressing mode to be 
saved in bit of general register 14 
and that bits 1-31 of general register 
14 are unchanged. Thus, when "BSM 0,14" 
is executed in the new program, control 
passes directly back to the old program 
without passing through the glue module 
again. 



Old Program 



Glue Module 



New Program 



L 15,0LDVC0N 
BALR 14,15 



OLDVCON DC VV(GLUE) 




GLUE USING x,15 

L 15,NEWVC0N 

BSM 14,15 

NEWVCON DC V(NEW) 



NEW USING *,15 




0,14 



Glue Module 



i 
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INTERRUPTIONS 



sequential instruc- 



> 



Interruptions permit the CPU to change 
state as a result of conditions external 

in subchannels or 
devices, in other 



to the system, 

input/output (I/O) 

CPUs, or in the CPU itself. Details are 



to be found 
"Interruptions." 



in 



Chapter 



Six classes of interruption condi 
are provided: external, I/O, ma 
check, program, restart, and super 
call. Each class has two related 
called old and new, in perman 
assigned real storage locations. I 
classes, an interruption involves 
ing information identifying the cau 
the interruption, storing the cu 
PSW at the old-PSW location, and f 
ing the PSW at the new-PSW loca 
which becomes the current PSW. 



6, 



tions 
chine 
vi sor 
PSWs, 
ently 
n all 
stor- 
se of 
rrent 
etch- 
tion, 



The old PSW contains CPU-status informa- 
tion necessary for resumption of the 
interrupted program. At the conclusion 
of the program invoked by the intei — 
ruption, the instruction LOAD PSW may be 
used to restore the current PSW to the 
value of the old PSW. 



TYPES OF INSTRUCTION ENDING 



Instruction execution ends in one of 

five ways: completion, nullification, 

suppression, termination, and partial 
completi on. 

Partial completion of instruction 
execution occurs only for i nterrupti ble 
instructions; it is described in the 
section "Interrupt! ble Instructions" 
later in this chapter. 



Completion 



Completion of instruction execution 
provides results as called for in the 
definition of the instruction. When an 
interruption occurs after the completion 
of the execution of an instruction, the 
instruction address in the old PSW 
designates the next sequential instruc- 
ti on. 



truction execution 
t as suppression, 
interruption occurs 
of an instruction 
the instruction 
PSW designates the 
ecution was nulli- 
E instruction, as 
of the next sequen- 



designates the next 
ti on. 



Nulli f icati on 



Nullification of ins 
has the same effec 
except that when an 
after the execution 
has been nullified, 
address in the old 
instruction whose ex 
fied (or an EXECUT 
appropriate) instead 
tial instruction. 



Termination 



Termination of instruction execution 
causes the contents of any fields due to 
be changed by the instruction to be 
unpredictable. The operation may 
replace all, part, or none of the 
contents of the designated result fields 
and may change the condition code if 
such change is called for by the 
instruction. Unless the interruption is 
caused by a machine-check condition, the 
validity of the instruction address in 
the PSW, the interruption code, and the 
ILC are not affected, and the state or 
the operation of the machine is not 
affected in any other way. The instruc- 
tion address in the old PSW on an 
interruption after termination desig- 
nates the next sequential instruction. 



Programming Note 



Although the execution of an instruction 
is treated as a no-operation when 
suppression or nullification occurs, 
stores may be performed as the result of 
the implicit tracing action associated 
with some instructions. See the section 
"Tracing" in Chapter 4, "Control." 



INTERRUPTIBLE INSTRUCTIONS 



Point of Interruption 



> 



Suppression 



Suppression of instruction execution 
causes the instruction to be executed as 
if it specified "no operation." The 
contents of any result fields, including 
the condition code, are not changed. 
The instruction address in the old PSW 
on an interruption after suppression 



For most instructions, the entire 
execution of an instruction is one opei — 
ation. An interruption is permitted 
between operations; that is, an inter- 
ruption can occur after the performance 
of one operation and before the start of 
a subsequent operation. 

For the following instructions, referred 
to as interruptible instructions, an 
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interruption is permitted after partial 
completion of the instruction: 

COMPARE AND FORM CODEWORD 

COMPARE LOGICAL LONG 

MOVE LONG 

TEST BLOCK 

UPDATE TREE 

Interrupt i bie instructions of the 
vector facility (see the publi- 
cation IBM System/370 Vector 
Operations , SA22-7125) 

The execution of an interrupti ble 
instruction is considered to consist in 
the execution of a number of units of 
operation, and an interruption is 
permitted between units of operation. 
The amount of data processed in a unit 
of operation depends on the particular 
instruction and may depend on the model 
and on the particular condition that 
causes the execution of the instruction 
to be interrupted. 

Whenever points of interruption that 
include those occurring within the 
execution of an i nterrupti ble instruc- 
tion are discussed, the term "unit of 
operation" is used. For a noninterrup- 
tible instruction, the entire execution 
consists, in effect, in the execution of 
one unit of operation. 



When an instruction consis 
of units of operation a 
ruption occurs after some, 
units of operation have b 
the instruction is said t 
completed. In this case, 
ending (completion, inhibi 
cation, suppression) is a 
the unit of operation. I 
termination, the entire i 
terminated, not just the 
tion. 



ts of a number 
nd an inter- 
but not all, 
een completed, 
o be partially 
tha type of 
tion, nullifi- 
ssociated with 
n the case of 
nstruction is 
unit of opera- 



Execution of Interrupti ble Instructi ons 



The execution of an interruptible 
instruction is completed when all units 
of operation associated with that 
instruction are completed. When an 
interruption occurs after completion, 
inhibition, nullification, or suppres- 
sion of a unit of operation, all preced- 
ing units of operation have been 
completed, and subsequent units of oper- 
ation and instructions have not been 
started. The main difference between 
these types of ending is the handling of 
the current unit of operation and wheth- 
er the instruction address stored in the 
old PSW identifies the current instruc- 
tion or the next instruction. 

At the time of an interruption, changes 
to register contents, which are due to 
be made by an interruptible vector 
instruction beyond the point of intei — 
ruption, have not yet been made. Chang- 



es to storage locations, however, which 
are due to be made by an interruptible 
vector instruction beyond the point of 
interruption, may have occurred for one 
or more storage locations beyond the 
location containing the element identi- 
fied by the interruption parameters, but 
not for any location beyond the last 
element specified by the instruction and 
not for any locations for which access 
exceptions exist. Changes to storage 
locations or register contents which are 
due to be made by instructions following 
the interrupted instruction have not yet 
been made at the time of interruption. 

Completi on : On completion of the last 
unit of operation of an interruptible 
instruction, the instruction address in 
the old PSW designates the next sequen- 
tial instruction. The result location 
for the current unit of operation has 
been updated. It depends on the partic- 
ular instruction how the operand 
parameters &re adjusted. On completion 
of a unit of operation other than the 
last one, the instruction address in the 
old PSW designates the interrupted 
instruction or an EXECUTE instruction, 
as appropriate. The result location for 
the current unit of operation has been 
updated. The operand parameters are 
adjusted such that the execution of the 
interrupted instruction is resumed from 
the point of interruption when the old 
PSW stored during the interruption is 
made the current PSW. 



ti on is 
ess in 
rrupted 
ucti on, 
ion for 
i s not 
rs are 
ruction 

i ntei — 
ith the 
i bi t i on 

vector 
n more 
tem/370 



Inhibi ti on : When a unit of opera 
inhibited, the instruction addr 
the old PSW designates the inte 
instruction or an EXECUTE instr 
as appropriate. The result locat 
the current unit of operation 
changed. The operand paramete 
adjusted such that, if the inst 
is reexecuted, execution of the 
rupted instruction is resumed w 
next unit of operation. Inh 
occurs only during interruptible 
instructions and is described i 

detail in the publication IBM Svs 

Vector Operations , SA22-7125. 

Nulli f icati on : When a unit of operation 
is nullified, the instruction address in 
the old PSW designates the interrupted 
instruction or an EXECUTE instruction, 
as appropriate. The result location for 
the current unit of operation remains 
unchanged. The operand parameters are 
adjusted such that, if the instruction 
is reexecuted, execution of the intei — 
rupted instruction is resumed with the 
current unit of operation. 

Suppressi on : When a unit of operation 
is suppressed, the instruction address 
in the old PSW designates the next 
sequential instruction. The operand 
parameters, however, are adjusted so as 
to indicate the extent to which instruc- 
tion execution has been completed. If 
the instruction is reexecuted after the 
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conditions causing the suppression have 
been removed, the execution is resumed 
with the current unit of operation. 

Termi nati on ? When an exception which 
causes termination occurs as part of a 
unit of operation of an i nterrupti ble 
instruction* the entire operation is 
terminated, and the contents, in 
general, of any fields due to be changed 



by the instruction are unpredictable. 
On such an interruption, the instruction 
address in the old PSW designates the 
next sequential instruction. 

The differences among the five types of 
ending for a unit of operation are 
summarized in the figure "Types of 
Ending for a Unit of Operation." 



Unit of 


Instructi on 


Operand 


Current Result 


Operation Is 


Address 


Parameters 


Locati on 


Completed 








Last unit of 


Next instruc- 


Depends on the 


Changed 


operati on 


tion 


instruction 




Any other unit 


Current in- 


Next unit of 


Changed 


of operation 


structi on 


operati on 




Inhibi ted 


Current in- 


Next unit of 


Unchanged 




structi on 


operation 




Nullified 


Current in- 


Current unit 


Unchanged 




structi on 


of operation 




Suppressed 


Next instruc- 


Current unit 


Unchanged 




ti on 


of operation 




Terminated 


Next instruc- 
ti on 


Unpredictable 


Unpredictable 



I 



Types of Ending for a Unit of Operation 



J 
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Programming Notes 



Any inter 
visor cal 
ruptions, 
executi on 
i nstructi 
ruptions 
machi ne-c 
i nterrupt 
and PER 
units of 



rupti on 
1 and 
can oc 

of 
on. In 

for 
heck, r 
ions fo 
events 
operati 



, other than supei — 
some program inter- 
cur after a partial 
an interrupti ble 
particular* intei — 
external, I/O, 
estart, and program 
r access exceptions 
can occur between 
on . 



requested 
an intei — 
the CPU 



The amount of data processed in a 
unit of operation of an interrupti- 
ble instruction depends on the 
model and may depend on the type of 
condition which causes the 
execution of the instruction to be 
interrupted or stopped. Thus, when 
an interruption occurs at the end 
of the current unit of operation, 
the length of the unit of operation 
may be different for different 
types of interruptions. Also, when 
the stop function is 
during the execution of 
ruptible instruction, 
enters the stopped state at the 
completion of the execution of the 
current unit of operation. Simi- 
larly, in the instruction-step 
mode, only a single unit of opera- 
tion is performed, but the unit of 
operation for the various cases of 
stopping may be different. 



EXCEPTIONS TO NULLIFICATION AND 
SUPPRESSION 



In certain unusual situations, the 
result fields of an instruction having a 
store-type operand are changed in spite 
of the occurrence of an exception which 
would normally result in nullification 
or suppression. These situations are 
exceptions to the general rule that the 
operation is treated as a no-operation 
when an exception requiring nullifica- 
tion or suppression is recognized. Each 
of these situations may result in the 
turning on of the change bit associated 
with the store-type operand, even though 
the final result in storage may appear 
unchanged. Depending on the particular 
situation, additional effects may be 
observable. The extent of these effects 
is described along with each of the 
si tuati ons. 
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occur and 
the store 
CPU, a sto 
ever an ac 
access, or 
which is 
priority o 
access. 



ese situatio 
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When, in these situations, an inter- 
ruption for an exception requiring 
suppression occurs, the instruction 
address in the old PSW designates the 
next sequential instruction. When an 
interruption for an exception requiring 
nullification occurs, the instruction 
address in the old PSW designates the 
instruction causing the exception even 
though partial results may have been 
stored. 



Storage Change and Restorati on f oi 
DAT-Associated Access Excepti ons 



In this section, the term "DAT- 
associated access exceptions" is used to 
refer to those exceptions which may 
occur as part of the dynamic-address- 
translation process. These exceptions 
are page translation, segment trans- 
lation, translation specification, and 
addressing due to 
being designated at 
not available in the 
first two of these 
cause nullification, 



a DAT-table entry 
a location that is 
configuration. The 
exceptions normally 
and the last two 



normally cause suppression. Protection 
exceptions, including those due to page 
protection, are not considered to be 
DAT-associated access exceptions. 

For DAT-associated access exceptions, on 
some models, channel programs may 
observe the effects on storage as 
described in the following case. 

When, for an instruction having a 
store-type operand, a DAT-associated 
access exception is recognized for any 
operand of the instruction, that 
portion, if any, of the store-type opei — 
and which would not cause an exception 
may be changed to an intermediate value 
but is then restored to the original 
value. 

The accesses associated with storage 
change and restoration for DAT- 
associated access exceptions are only 
observable by channel programs and are 
not observable by other CPUs in a multi- 
processing configuration. Except for 
instructions which are defined to have 
multiple-access operands, the intermedi- 
ate value, if any, is always equal to 
what would have been the final value if 
the DAT-associated access exception had 
not occurred. 



Programming Notes 



Storage change and restoration for 
DAT-associated access exceptions 
occur in two main situations: 



Ik 
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a. The exception is recognized for 
a portion of a store-type opei — 
and which crosses a page bound- 
ary, and the other portion has 
no access exception. 

b. The exception is recognized for 
one operand of an instruction 
having two storage operands 
(for example, an SS-format 
instruction or MOVE LONG), and 
the other operand, which is a 
store-type operand, has no 
access exception. 

2. To avoid letting a channel program 
observe intermediate operand values 
due to storage change and restora- 
tion for DAT-associated access 
exceptions (especially when a CCUI 
chain is modified), the CPU program 
should do one of the following: 

• Operate on one storage page at 
a time 

• Perform preliminary testing to 
ensure that no exceptions occur 
for any of the required pages 

• Operate with DAT off 



Modi f ication of DAT-Table Entries 



When a valid and attached DAT-table 
entry is changed to a value which would 
cause an exception, and when, before the 
TLB is cleared of entries which qualify 
for substitution for that entry, an 
attempt is made to refer to storage by 
using a virtual address requiring that 
entry for translation, the contents of 
any fields due to be changed by the 
instruction are unpredictable. Results, 
if any, associated with the virtual 
address whose DAT-table entry was 
changed may be placed in those real 
locations originally associated with the 
address. Furthermore, it is unpredict- 
able whether or not an interruption 
occurs for an access exception that was 
not initially applicable. On some 
machines, this situation may be reported 
by means of an instruction-processing- 
damage machine check with the delayed- 
access-excepti on bit also indicated. 



Trial E xecuti on for Edi t i ng Instructi ons 
and TRANSLATE 



the instruction in which results are not 
stored. If the first operand of TRANS- 
LATE or either operand of EDIT or EDIT 
AND MARK is changed by another CPU or by 
a channel program, after the initial 
trial execution but before completion of 
execution, the contents of any fields 
due to be changed by the instruction are 
unpredictable. Furthermore, it is 
unpredictable whether or not an intei — 
ruption occurs for an access exception 
that was not initially applicable. 



Interlocked Update for Nullif icati on and 
Suppressi on 



When an exception which is defined to 
cause suppression or nullification is 
recognized for an instruction with a 
store-type operand, an interlocked- 
update reference which does not change 
the contents of the location may occur 
for that portion, if any, of the store- 
type operand for which no access 
exception exists. The interlocked- 
update reference can occur only if the 
priority of the exception is equal to or 
lower than the priority of an access 
exception for the store-type operand. 

When the exception is a specification 
exception for a store-type operand which 
requires alignment on integral bounda- 
ries, the interlocked-update reference 
which may occur is limited to the single 
byte at the location designated by the 
operand address. 



Programming Note 



The update appears to be an inter- 
locked-update reference as observed by 
other CPUs. It is not interlocked as 
observed by channel programs. Examples 
of when an interlocked-update reference 
may occur to the destination-operand 
location in storage are: 

• Specification exception for an odd 
register number for COMPARE DOUBLE 
AND SWAP 

• Data exception for an invalid deci- 
mal sign for ADD DECIMAL 

• Decimal-divide exception for DIVIDE 
DECIMAL 



| 



For the instructions EDIT, EDIT AND 
MARK, and TRANSLATE, the portions of the 
operands that are actually used in the 
operation may be established in a trial 
execution for operand accessibility that 
is performed before the execution of the 
instruction is started. This trial 
execution consists in an execution of 



AUTHORIZATION MECHANISMS 



The authorization mechanisms which are 
described in this section permit the 
control program to establish the degree 
of function which is provided to a 
particular semipri vi leged program. (A 
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summary of the authorization mechanisms 
is given in the figure "Summary of 
Authorization Mechanisms.") The authori- 
zation mechanisms are intended for use 
by programs considered to be semiprivi- 
leged, that is, programs which are 
executed in the problem state but which 
may be authorized to use additional 
capabilities. With these authorization 
controls, a hierarchy of programs may be 
established, with programs at a higher 
level having a greater degree of privi- 
lege or authority than programs at a 
lower level. The range of functions 
available at each level, and the ability 
to transfer control from a lower to a 
higher level, are specified in tables 
which are managed by the control 
program. 

The 13 instructions which are controlled 
by the authorization mechanisms are 
called semi pri vi leged instructions and 
are described in Chapter 10, "Control 
Instructions." The 13 semipri vi leged 
instructions, along with the privileged 
instruction LOAD ADDRESS SPACE PARAME- 
TERS, are listed in the next figure, 
"Summary of Authorization Mechanisms." 



EXTRACT PRIMARY ASN 
EXTRACT SECONDARY ASN 
INSERT ADDRESS SPACE CONTROL 
INSERT PSW KEY 
INSERT VIRTUAL STORAGE KEY 

Otherwise, a privileged-operation excep- 
tion is recognized. The extraction- 
authority-control bit is not examined in 
the supervisor state. 



PSW-Kev Mask 



The PSW-key mask consists o 
in control register 3. The 
used in the problem state 
which keys and entry points 
i zed for the program. The 
is modified by PROGRAM CALL 
TRANSFER and is loaded by 
SPACE PARAMETERS. The PSW- 
used in the problem state to 
followi ng: 



f bits 0-15 
se bits are 

to control 

are author- 
PSW-key mask 

and PROGRAM 
LOAD ADDRESS 
key mask i s 

control the 



The PSW-key values that can be set 
by means of the instruction SET PSW 
KEY FROM ADDRESS. 



Proqrammi ng Note 



The authorization mechanisms are defined 
such that if zeros are placed in the 
associated control-register positions, a 
problem program attempting to use the 
semi pri vi leged instructions causes a 
privileged-operation or special- 
operation exception to be recognized. 



The PSW-key values that are valid 
for the three move instructions 
that specify a second access key: 
MOVE TO PRIMARY, MOVE TO SECONDARY, 
and MOVE WITH KEY. 

The entry points which can be 
called by means of PROGRAM CALL. 
In this case, the PSW-key mask is 
ANDed with the authorization key 
mask in the entry-table entry, and, 
if the result is zero, the program 
is not authorized. 



Mode Regui rements 



Most of the semi pri vi leged instructions 
can be executed only with DAT on. 
PROGRAM CALL and PROGRAM TRANSFER are 
valid only in the primary-space mode. 
When a semi pri vi leged instruction is 
executed in an invalid translation mode, 
a special-operation exception is recog- 
ni zed. 



When an instruction in the 
attempts to use a key not 
the PSW-key mask, a privil 
exception is recognized 
action is taken when an 
the problem state attempt 
entry not authorized by 
mask. The PSW-key mask i 
in the supervisor state, 
entry points being valid. 



problem state 

authorized by 

eged-operat i on 

The same 

instruction in 

s to call an 

the PSW-key 

s not examined 

all keys and 



PROGRAM TRANSFER specifies a new value 
for the problem-state bit in the PSW. 
If a program in the problem state 
attempts to execute PROGRAM TRANSFER and 
set the supervisor state, a privileged- 
operation exception is recognized. 



Extract i on-Authori tv Control 



The extraction-authority-control bit is 
located in bit position 4 of control 
register 0. In the problem state, bit 4 
must be one to allow completion of these 
i nstructi ons: 



Secondary-Space Control 



Bit 5 of control register is the 
secondary-space-control bit. This bit 
provides a mechanism whereby the control 
program can indicate whether or not the 
secondary segment table has been estab- 
lished. Bit 5 must be one to allow 
completion of these instructions: 

MOVE to PRIMARY 

MOVE TO SECONDARY 

SET ADDRESS SPACE CONTROL 



if 



5-16 370-XA Principles of Operation 



I 



Otherwise, a special-operation exception 
is recognized. The secondary-space- 
control bit is examined in both the 
problem and" supervisor states. 



Subsvstem-L i nkage Control 



Bit of control register 5 is the 

subsystem-linkage-control bit. Bit 

must be one to allow completion of these 
instructions: 

PROGRAM CALL 
PROGRAM TRANSFER 

Otherwise, a special-operation exception 
is recognized. The subsystem-linkage- 
control bit is examined in both the 
problem and supervisor states and 
controls both the space-switching and 
current-primary versions of the 
i nstructi ons. 



ASN-Translation Control 



Bit 12 of control register 14 is the 
ASN-translation-control bit. This bit 
provides a mechanism whereby the control 
program can indicate whether ASN trans- 
lation may occur while a particular 
program is being executed. Bit 12 must 
be one to allow completion of these 
instructions: 

LOAD ADDRESS SPACE PARAMETERS 
SET SECONDARY ASN 
PROGRAM CALL with space switching 
PROGRAM TRANSFER with space switch- 
ing 

Otherwise, a special-operation exception 
is recognized. The ASN-translation- 
control bit is examined in both the 
problem and supervisor states. 



Author i zation Index 



authorization index is associated with 
the primary address space and is loaded 
along with the PASN when PROGRAM CALL 
with space switching, PROGRAM TRANSFER 
with space switching, or LOAD ADDRESS 
SPACE PARAMETERS is executed. The 
authorization index is used to determine 
whether a program is authorized to 
establish a particular address space. A 
program may be authorized to establish 
the address space as a secondary-address 
space, as a primary-address space, or 
both. The authorization index is exam- 
ined in both the problem and supervisor 
states. 

Associated with each address space is an 
authority table. The authorization 
index is used to select an entry in the 
authority table. Each entry contains 
two bits, which indicate whether the 
program with that authorization index is 
permitted to establish the address space 
as a primary address space, as a second- 
ary address space, or both. 



The instruct 
space switch 
index to te 
bit in the 
determine if 
establi shed 
space. The 
otherwise, a 
tion is reco 



ion SET SECONDARY ASN with 
ing uses the authorization 
st the secondary-authority 

authority-table entry to 

the address space can be 
as a secondary address 

tested bit must be one; 

secondary-authority excep- 
gni zed. 



The instruction PROGRAM TRANSFER with 
space switching uses the authorization 
index to test the primary authority bit 
in the authority-table entry to detei — 
mine if the address space can be estab- 
lished as a primary address space. The 
tested bit must be one; otherwise, a 
primary-authority exception is recog- 
ni zed. 

The instruction PROGRAM CALL with space 
switching causes a new authorization 
index to be loaded from the ASN-second- 
table entry. This permits the program 
which is called to be given an authori- 
zation index which authorizes it to 
access more address spaces than those 
authorized for the calling program. 



The authorization index is contained in 
bits 0-15 of control register 4. The 
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Instr 






Authorization Mechanism 


Space- 

Swi tch- 

Event- 

Control 

Bit 

(CRl.O) 


Mode 
Requi rement 


Subsystem- 
Li nkage 
Control 
(CR5.0) 


Secondary- 
Space 
Control 
(CR0.5) 


ASN- 
Translati on- 
Control 
(CR14.12) 


Extract i on- 
Authori ty 
Control 
(CR0.4) 


PSW- 
Key Mask 
(CR3.0-15) 


Authori- 
zati on 
Index 
(CR4.0-15) 


Priv 
Op 


Trans 
Mode 


Bit 
Test 


AND 
AKM 1 


Uncd 


Cond 


EPAR 

ESAR 

IAC 

IPK 

IVSK 

LASP 


P 


SO-PS 
SO-PS 
SO-PS 

SO-PS 






SO 




Q 
Q 
Q 
Q 
Q 






CC 


CC 


MVCP 

MVCS 

MVCK 

PC-cp 

PC-ss 




SO-PS 
SO-PS 

SO-P 
SO-P 


SO 
SO 


SO 
SO 




SO 




Q 
Q 
Q 


Q 

Q 




X 


PT-cp 

PT-ss 

SAC 

SPKA 

SSAR-cp 

SSAR-ss 


Q 2 
Q 2 


SO-P 
SO-P 
SO-PS 

SO-PS 
SO-PS 


SO 
SO 


SO 


SO 
SO 


SO 




Q 




PA 
SA 


X 


Explanati on: 




i 

2 

cc 

CRx.y 

P 

PA 

Q 


The PSW-key mask is ANDed with the authorization key mask in the entry-table entry. 

The exception is recognized on an attempt to set the supervisor state when in the 
problem state. 

Space-switch-event-control bit and authorization index tests cause a condition code to 
be set. 

Control register x, bit position y. 

Privileged-operation exception for privileged instruction. 

Authority checked in the problem state and the supervisor state; violation causes a 
primary-authority exception. 

Privileged-operation exception for semi pri vi leged instruction. Authority checked only 
in the problem state. 



SA Authority checked in the problem state and the supervisor state; violation causes a 

secondary-authority exception. 

SO Authority checked in the problem state and the supervisor state; violation causes a 

special-operation exception. 

SO-P CPU must be in the primary-space mode; if the CPU is in the secondary-space mode or 
in the real mode, a special-operation exception is recognized in the problem state 
and the supervisor state. 

SO-PS CPU must be in the primary-space mode or the secondary-space mode; if the CPU is in 
the real mode, a special-operation exception is recognized in the problem state and 
the supervisor state. 

X When bit of control register 1 is one, a space-switch event is recognized. The 

operation is completed. The event is recognized in the problem state and the super- 
visor state. 



Summary of Authorization Mechanisms 



PC-NUMBER TRANSLATION 



PC-number translation is the process of 
translating the 20-bit PC number to 
locate an entry-table entry as part of 
the execution of the PROGRAM CALL 
instruction. To perform this trans- 
lation* the 20-bit PC number is divided 
into two fields. Bits 12-23 are the 
linkage index (LX), and bits 24-31 &re 



the entry index (EX). The effective 
address, from which the PC-number is 
taken, has the following format: 



//////////// 


LX 


EX 



12 



24 



31 



The translation is performed by means of 
two tables: a linkage table and an 



\ 
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entry table. Both of these tables 
reside in real storage. The linkage- 
table designation resides in control 
register 5. The entry table is desig- 
nated by means of a linkage-table entry. 



PC-NUMBER TRANSLATION CONTROL 



PC-number translation is controlled by 
means of the linkage-table designation 
in control register 5. The register has 
the following format: 



V 


Linkage-Table Origin 


LTL 



25 



31 



Subsvstem-L i nkage Control (V): Bit of 
control register 5 is the subsystem- 
linkage-control bit. Bit must be one 
to allow completion of these 
i nstructi ons: 

PROGRAM CALL 
PROGRAM TRANSFER 

Otherwise* a special-operation exception 
is recognized. The system-linkage- 
control bit is examined in the problem 
state and the supervisor state and 
controls both the space-switching and 
current-primary versions of the 
i nstructi ons. 

Li nkage-Table Ori gi n : Bits 1-24 of 
control register 5, with seven zeros 
appended on the right , form a 31-bit 
real address that designates the begin- 
ning of the linkage table. 

Linkage-Table Length (LTL): Bits 25-31 
of control register 5 specify the length 
of the linkage table in units of 128 
bytes, thus making the length of the 
linkage table variable in multiples of 
32 four-byte entries. The length of the 
linkage table, in units of 128 bytes, is 
one more than the value in bit positions 
25-31. The linkage-table length is 
compared against the leftmost seven bits 
of the linkage-index portion of the PC 
number to determine whether the linkage 
index designates an entry within the 
linkage table. 



PC-NUMBER TRANSLATION TABLES 



The PC-number translation process 
consists in a two-level lookup using two 
tables: a linkage table and an entry 
table. These tables reside in real 
storage. 



Li nkage-Table Entri es 



The entry fetched from the linkage table 
has the following format: 



I 


Entry-Table Origin 


ETL 



26 



31 



The fields in the linkage-table entry 
are allocated as follows: 

LK Invalid Bit (I): Bit controls 
whether the entry table associated with 
the linkage-table entry is available. 

When the bit is zero, PC-number trans- 
lation proceeds by using the linkage- 
table entry. When the bit is one, an 
LX-translation exception is recognized. 

Entry-Table Origin : Bits 1-25, with six 
zeros appended on the right, form a 
31-bit real address that designates the 
beginning of the entry table. 



Entry-Table Length ( ETL ): Bi 
specify the length of the entry 
units of 64 bytes, thus making 
table variable in multiples 
16-byte entries. The length 
entry table, in units of 64 
one more than the value in bit 
26-31. The entry-table le 
compared against the leftmost 
of the entry index to determin 
the entry index designates 
within the entry table. 



Entry-Table Entri es 



The entry fetched from the entry table 
is 16 bytes in length and has the 
following format: 



ts 26-31 

table in 

the entry 

of four 

of the 

bytes, is 

posi ti ons 

ngth i s 

six bits 

e whether 

an entry 



Auth Key Mask 


ASN 


16 31 


A 


Entry Instruction Address 


P 


32 63 


Entry Parameter 


64 95 


Entry Key Mask 


//////////////// 



96 



112 



127 



The fields in the entry-table entry are 
allocated as follows: 
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Authorization Key Mask : Bits 0-15 are 
used to verify whether the program issu- 
ing the PROGRAM CALL instruction, when 
in the problem state* is authorized to 
call this entry point. The authori- 
zation key mask and the current PSW-key 
mask in control register 3 are ANDed, 
and the result is checked for all zeros. 
If the result is all zeros, a 
privileged-operation exception is recog- 
nized. The test is not performed in the 
supervisor state. 

ASN : Bits 16-31 specify whether a PC-ss 
or PC-cp is to occur. When bits 16-31 
are zeros, a PC-cp is specified. When 
bits 16-31 are not all zeros, a PC-ss is 
specified, and the bits contain the ASN 
that replaces the primary ASN. 

Entry Addressing Mode (£) : Bit 32 
replaces the addressing-mode bit, bit 32 
of the current PSW, as part of the 
PROGRAM CALL operation. When bit 32 is 
zero, bits 33-39 must also be zero; 
otherwise, a PC-translation-specifica- 
tion exception is recognized. 

Entry Instructi on Address ? Bits 33-62, 
with a zero appended on the right, forjn 
the instruct inn address whi cfa. ..xepfa Hak, 




Entry Parameter : Bits 
in general register 4. 



64-95 are placed 



Entry Key Mask : 
into the PSW key 
ter 3 as part of 
ti on. 



Bits 96-111 are ORed 

mask in control regis- 

the PROGRAM CALL opera- 



Programming Note 



The entry parameter is intended to 
provide the called program with an 
address which can be depended upon and 
used as the basis of addressability in 
locating necessary information which may 
be environment-dependent. The parameter 
may be appropriately changed for each 
environment by setting up different 
entry tables. The alternative — 
obtaining this information from the 
calling program — may require extensive 
validity checking or may present an 
integrity exposure. 



PC-NUMBER-TRANSLATION PROCESS 



The translation of the PC number is 
performed by means of a linkage table 
and entry table both of which reside in 
real storage. 

For the purposes of PC-number trans- 
lation, the 20-bit PC number is divided 
into two parts: the leftmost 12 bits 
are called the linkage index (LX), and 
the rightmost eight bits are called the 
entry index (EX). The LX is used to 
select an entry from the linkage table, 
the starting address and length of which 
are specified by the contents of the 
linkage-table designation in control 
register 5. This entry designates the 
entry table to be used. The EX field of 
the PC number is then used to select an 
entry from the entry table. 

When, for the purposes of PC-number 
translation, accesses are made to main 
storage to fetch entries from the link- 
age table and entry table, key- 
controlled protection does not apply. 

The PC-number-translation process is 
shown in the figure "PC-Number Trans- 
lation." 



4 
X 
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CR5 V LTO LTL 



(xl28) 



Linkage Table 



ETO 



ETL 



(x64) 



PC Number 



LX 



EX 



Cx4) 



(xl6) 





y 


Entry Table 


















I 


I 


AKM 


ASN 


A 


IA 


P 


PARM 


EKM 


//////// 







R: Address is real 



PC-Number Translation 



Linkage-Table Lookup 



The linkage-index CLX) portion of the PC 
number, in conjunction with the 
linkage-table origin* is used to select 
an entry from the linkage table. 



The 31-bit real address o 
table entry is obtained 
seven zeros on the right t 
of bit positions 1-24 of 
ter 5 and adding the linka 
two rightmost and 17 1 
appended. A carry, if 
position is ignored. A 
the address are used, 
whether the current PSW 
24-bit or 31-bit addressin 



f the linkage- 
by appending 
o the contents 
control regis- 
ge index, with 
eftmost zeros 
any, into bit 
11 31 bits of 
regardless of 
specifies the 
g mode. 



> 



As part of the linkage-table-lookup 
process, the leftmost seven bits of the 
linkage index are compared against the 
linkage-table length, bits 25-31 of 
control register 5, to establish whether 
the addressed entry is within the link- 
age table. If the value in the 
linkage-table-length field is less than 



the value in the seven leftmost bits of 
the linkage index, an LX-translati on 
exception is recognized. 

All four bytes of the linkage-table 
entry appear to be fetched concurrently 
as observed by other CPUs. The fetch 
access is not subject to protection. 
When the storage address which is genei — 
ated for fetching the linkage-table 
entry designates a location which is not 
available in the configuration, an 
addressing exception is recognized, and 
the operation is suppressed. 

Bit of the linkage-table entry speci- 
fies whether the entry table correspond- 
ing to the linkage index is available. 
This bit is inspected, and, if it is 
one, an LX-translati on exception is 
recogni zed. 

When no exceptions are recognized in the 
process of linkage-table lookup, the 
entry fetched from the linkage table 
designates the origin and length of the 
corresponding entry table. 
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Entry-Table Lookup 



The entry-index (EX) portion of the PC 
number, in conjunction with the entry- 
table origin contained in the linkage- 
table entry, is used to select an entry 
from the entry table. 



The 31-bit real addre 
table entry is obtaine 
zeros on the right t 
origin and adding the 
four rightmost and 1 
appended. A carry, 
position is ignored 
the address are use 
whether the current 
24-bit or 31-bit addre 



ss of the entry- 
d by appending six 
o the entry-table 
entry index, with 
9 leftmost zeros 
if any, into bit 
All 31 bits of 
d, regardless of 
PSW specifies the 
ssing mode. 



As part of the ent 
ess, the six leftmo 
index are compared 
table length, b 
linkage-table entry 
er the addressed 
table. If the valu 
length field is le 
the six leftmost 
index, an EX-trans 
recogni zed. 



ry-table-lookup proc- 
st bits of the entry 
against the entry- 
its 26-31 of the 
, to establish wheth- 
entry is within the 
e in the entry-table 
ss than the value in 
bits of the entry 
lation exception is 



The 16-byte entry-table entry is fetched 
by using the real address. The entry 
appears to be fetched word-concurrent as 
observed by other CPUs, with the left" 
most word fetched first. The order in 
which the remaining three words are 
fetched is unpredictable. The fetch 
access is not subject to protection. 
When the storage address which is genei — 
ated for fetching the entry-table entry 
designates a location which is not 
available in the configuration, &n 
addressing exception is recognized, and 
the operation is suppressed. 

The use that is made of the information 
fetched from the entry-table entry is 
described in the definition of the 
PROGRAM CALL instruction. 



R ecogni ti on of Excepti ons duri ng 
PC-Number Translati on 



The exceptions which can be encountered 
during the PC-numbei — translation process 
and their priority are described in the 
definition of the PROGRAM CALL instruc- 
tion. 



SEQUENCE OF STORAGE REFERENCES 



The following sections describe the 
effects of overlapped operation and of 
piecemeal execution of a CPU program as 
that execution is observed in storage. 
Except for the section "Interlocks for 



Virtual-Storage References," the effects 
described in these sections are observa- 
ble only when two or more CPUs or 
channel programs are in simultaneous 
execution and access common storage 
locations. Thus, in most cases, the 
program must take into account the 
effects which are described in these 
sections only for those cases in which 
the program interacts with a CPU or a 
channel program. 



Conceptual Sequence 



Conceptually, 
instructions 
execution of 
the execution 
tion. The ex 
desi gnated 
follows the 
Simi larly, an 
between instr 
ble instruct 
operation of 
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successful 
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branch 
branch, 
s place 
errupti - 
i ts of 



The sequence of events implied by the 
processing just described is sometimes 
called the conceptual sequence. 



Overlapped Qperati on of Instructi on 
Executi on 



Each operation of instruction execution 
appears to the program itself to be 
performed sequentially, with the current 
instruction being fetched after the 
preceding operation is completed and 
before the execution of the current 
operation is begun. This appearance is 
maintained even though the storage- 
implementation characteristics and 
overlap of instruction execution with 
storage accessing may cause actual proc- 
essing to be different. The results 
generated are those that would have been 
obtained had the operations been 
performed in the conceptual sequence. 
Thus, it is possible for an instruction 
to modify the next succeeding instruc- 
tion in storage. However, in certain 
situations involving dynamic address 
translation where different virtual 
addresses map to the same real address, 
the copies of prefetched instructions 
are not necessarily changed. Also, when 
a vectoi — facility instruction is 
executed that causes storing into a 
location from which subsequent 
instructions have been prefetched, the 
copies of the prefetched instructions 
are not necessarily changed. 

In simple models in which operations are 
not overlapped, the conceptual and actu- 
al sequences are essentially the same. 
However, in more complex machines, over- 
lapped operation, buffering of operands 



m 
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and results* and execution times which 
are comparable to the propagation delays 
between units can cause the actual 
sequence to differ considerably from the 
conceptual sequence. In these machines* 
special circuitry is employed to detect 
dependencies between operations and 
ensure that the results obtained* as 
observed by the CPU which generates 
them* are those that would have been 
obtained if the operations had been 
performed in the conceptual sequence. 
However* other CPUs and channel programs 
may* unless otherwise constrained* 
observe a sequence that differs from the 
conceptual sequence. 



Pi vi sible Instruction Executi on 



It can normally be assumed that the 
execution of each instruction occurs as 
an indivisible event. However, in actu- 
al operation* the execution of an 
instruction consists in a series of 
discrete steps. Depending on the 
instruction* operands may be fetched and 
stored in a piecemeal fashion* and some 
delay may occur between fetching opei — 
ands and storing results. As a 
consequence* intermediate or partially 
completed results may be observable by 
other CPUs and by channel programs. 



When a program interacts w 
tion on another CPU* or w 
program* the program may 
into consideration that a 
tion may consist in a ser 
references, that a storage 
in turn consist in a serie 
and that the conceptual 
sequences of these accesse 



ith the opera- 
i th a channel 

have to take 

single opera- 
i es of storage 

reference may 
s of accesses* 

and observed 
s may differ. 



Storage references associated with 
instruction execution are of the follow- 
ing types: instruction fetches* DAT- 
table fetches, and storage-operand 
references. For the purpose of describ- 
ing the sequence of storage references* 
accesses to storage in order to perform 
ASN translation* PC-number translation* 
and tracing are considered to be 
storage-operand references. 



Programming Note 



The sequence of execution of a CPU may 
differ from the simple conceptual defi- 
nition in the following ways: 

• As observed by the CPU itself* 
instructions may appear to be 
prefetched when different effective 
addresses are used. (See the 
section "Interlocks for Virtual- 
Storage References" in this 
chapter. ) 



As observed by other CPUs and by 
channel programs* the execution of 
an instruction may appear to be 
performed as a sequence of piece- 
meal steps. This is described for 
each type of storage reference in 
the following sections. 

As observed by other CPUs and by 
channel programs, the storage- 
operand accesses associated with 
one instruction are not necessarily 
performed in the conceptual se- 
quence. (See the section "Relation 
between Operand Accesses" in this 
chapter. ) 

As observed by channel programs* in 
certain unusual situations* the 
contents of storage may appear to 
change and then be restored to the 
original value. (See the section 
"Storage Change and Restoration for 
DAT-Associated Access Exceptions" 
in this chapter.) 



INTERLOCKS FOR VIRTUAL-STORAGE REFER- 
ENCES 
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When all accesses to a main-storage 
location are made by using the same 
effective address, then the above rule 
appears to be strictly maintained, as 
observed by the CPU itself. When 
different effective addresses are used 
to access the common location, the above 
rule does not hold in two cases: 
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the fetch are performed by means of 
different effective addresses, then 
the operand may appear to be 
fetched before the store. 

When an instruction changes the 
contents of a main-storage location 
from which a conceptually subse- 
quent instruction is to be 
executed, either directly or by 
means of EXECUTE, and when differ- 
ent effective addresses are used to 
designate that location for storing 
the result and fetching the 
instruction, the instruction may 
appear to be fetched before the 
store occurs. This does not occur 
if an intervening operation causes 
the prefetched instructions to be 
discarded. A definition of when 
prefetched instructions must be 
discarded is included in the 
section "Instruction Fetching" in 
this chapter. 
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Programmi ng Note 



A single main-storage location can 
accessed by more than one address 
several ways: 



be 
in 



The DAT tables may be set up such 
that multiple addresses in a single 
address space, or virtual addresses 
in different address spaces, map to 
a single real address. 

The translation of logical, 
instruction, and virtual addresses 
may be changed by loading the DAT 
parameters in the control 
registers, by changing the 
address-space-control bit in the 
PSW, or, for logical and instruc- 
tion addresses, by turning DAT on 
or off. 

Certain instructions use real 
addresses, and the instructions 
MOVE TO PRIMARY and MOVE TO SECOND- 
ARY access two address spaces. 

Accesses to storage for the purpose 
of storing and fetching information 
for interruptions is performed by 
means of real addresses, and, for 
the store-status function, by means 
of absolute addresses, whereas 



accesses by the program may be by 
means of virtual addresses. 

5. The real-to-absolute mapping may be 
changed by means of the SET PREFIX 
instruction or a reset. 

6. A main-storage location may be 
accessed by the channel subsystem 
by means of an absolute address and 
by the CPU by means of a real or a 
virtual address. 

7. A main-storage location may be 
accessed by another CPU by means of 
one type of address and by this CPU 
by means of a different type of 
address. 

The primary purpose of this section is 
to describe the effects caused in case 1 
above. 

For case 2, no effect is observable 
because prefetched instructions are 
discarded when the translation parame- 
ters are changed and the delay of stores 
by a CPU is not observable by the CPU 
itself. 

For case 3, for those instructions which 
fetch by using real addresses (for exam- 
ple, LOAD REAL ADDRESS), no effect is 
observable because only operand accesses 
between instructions are involved. All 
instructions that store by using a real 
address or that store into another 
address space cause prefetched 
instructions to be discarded, and no 
effect is observable. 

Cases 4 and 5 are situations which &r& 
defined to cause serialization, with the 
result that prefetched instructions are 
discarded. In these cases, no effect is 
observable. 

The handling of cases 6 and 7 involves 
accesses as observed by other CPUs and 
by channel programs and is covered in 
the following sections in this chapter. 
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tion. The instruction may be fetched 
multiple times for a single execution; 
for example, it may be fetched for test- 
ing the addressability of operands or 
for inspection of PER events, and it may 
be refetched for actual execution. 
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An instruction may be prefetched by 
using a virtual address only when the 
associated DAT table entries are 
attached and valid or when entries which 
qualify for substitution for the table 
entries exist in the TLB. An instruc- 
tion that has been prefetched may be 
interpreted for execution only for the 
same virtual address for which the 
instruction was prefetched. 

No limit is established on the number of 
instructions which may be prefetched, 
and multiple copies of the contents of a 
single storage location may be fetched. 
As a result, the instruction executed is 
not necessarily the most recently 
fetched copy. Storing caused by other 
CPUs and by channel programs does not 
necessarily change the copy of 
prefetched instructions; However, if a 
store that is conceptually earlier is 
made by the same CPU using the same 
effective address as that by which the 
instruction is subsequently fetched, the 
updated information is obtained. 

All copies of prefetched instructions 
are discarded when: 
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The CPU enters the operating state. 

The CPU changes from one to another 
of the following modes: primary- 
space mode, secondary-space mode, 
and real mode. 

A change is made to a translation 
parameter in control register 1 or 
7 when DAT is on . 



Programmi ng Notes 



1. As observed by a CPU itself, its 
own instruction prefetching is not 
normally apparent; the only excep- 
tion occurs when multiple virtual 
addresses in a single address 



space, or virtual addresses in 
different address spaces, map to a 
single real address. This is 
described in the section "Inter- 
locks for Virtual-Storage Refer- 
ences" in this chapter. 

The following are some effects of 
instruction prefetching on one CPU 
as observed by other CPUs and by 
channel programs. 

It is possible for one CPU to 
prefetch the contents of a storage 
location, after which another CPU 
or a channel program can change the 
contents of that storage location 
and then set a flag to indicate 
that the change has been made. 
Subsequently, the first CPU can 
test and find the flag set, branch 
to the modified location, and 
execute the original prefetched 
contents. 

It is possible, if another CPU or a 
channel program concurrently modi- 
fies the instruction, for one CPU 
to recognize the changes to some 
but not all bit positions of an 
i nstructi on . 

It is possible for one CPU to 
prefetch an instruction and subse- 
quently, before the instruction is 
executed, for another CPU to change 
the storage key. As a result, the 
first CPU may appear to execute 
instructions from a protected stoi — 
age location. However, the copy of 
the instructions executed is the 
copy prefetched before the location 
was protected. 



DAT-TABLE FETCHES 



The fetching of dynamic-address- 
translation (DAT) table entries may 
occur as follows: 

1. A DAT-table entry may be prefetched 
into the translation-lookaside 
buffer (TLB) and used from the TLB 
without refetching from storage, 
until the entry is cleared by an 
INVALIDATE PAGE TABLE ENTRY, PURGE 
TLB, or SET PREFIX instruction or 
by CPU reset. DAT-table entries 
are not necessarily fetched in the 
sequence conceptually called for; 
they may be fetched at any time 
they are attached and valid, 
including during the execution of 
conceptually previous instructions. 

2. All bytes of a DAT-table entry 
appear to be fetched concurrently, 
as observed by other CPUs. 
However, the reference to the entry 
may appear to access a single byte 
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5. 



at a time, as observed by channel 
programs. 

A DAT-tablt* entry may be fetched 
even after some operand references 
for the instruction have already 
occurred. The fetch may occur as 
late as just prior to the actual 
byte access requiring the DAT-table 
entry. 

A DAT-table entry may be fetched 
for each use of the address, 
including any trial execution, and 
for each reference to each byte of 
each operand. 

The DAT page-table-entry fetch 
precedes the reference to the page. 
When no copy of the page-table 
entry is in the TLB, the fetch of 
the associated segment-table entry 
precedes the fetch of the page- 
table entry. 



examined concurrently to set the 
condition code. The access to the 
storage key for RESET REFERENCE BIT 
EXTENDED follows the sequence rules 
for storage-operand update refei — 
ences. The reference bit is the 
only bit which is updated. 

The record of references provided by the 
reference bit is not necessarily accu- 
rate, and the handling of the reference 
bit is not subject to the concurrency 
rules. However, in the majority of 
situations, reference recording approxi- 
mately coincides with the storage 
reference. 

The change bit may be set in cases when 
no storing has occurred. See the 
section "Exceptions to Nullification and 
Suppression" in this chapter. 



STORAGE-OPERAND REFERENCES 



STORAGE-KEY ACCESSES 



References to the storage 
handled as follows: 



key are 



1. Whenever a reference to storage is 
made and key-controlled protection 
applies to the reference, the four 
access-control bits and the fetch- 
protection bit associated with the 
storage location Qre inspected 
concurrently with the reference to 
the storage location. 

2. When storing is performed, the 
change bit is set in the associated 
storage key concurrently with the 
store operation. 

3. The instruction SET STORAGE KEY 
EXTENDED causes all seven bits to 
be set concurrently in the storage 
key. The access to the storage key 
for SET STORAGE KEY EXTENDED 
follows the sequence rules for 
storage-operand store references 
and is a single-access reference. 

4. The INSERT STORAGE KEY EXTENDED 
instruction provides a consistent 
image of bits 0-6 of the storage 
key. Similarly, the instructions 
INSERT VIRTUAL STORAGE KEY and TEST 
PROTECTION provide a consistent 
image of bits 0-4 of the storage 
key. The access to the storage key 
for all of these instructions 
follows the sequence rules for 
storage-operand fetch references 
and is a single-access reference. 

5. The instruction RESET REFERENCE BIT 
EXTENDED modifies only the refer- 
ence bit. All other bits of the 
storage key remain unchanged. The 
reference bit and change bit are 



A storage-operand reference is the 
fetching or storing of the explicit 
operand or operands in the storage 
locations designated by the instruction. 

During the execution of an instruction, 
all or some of the storage operands for 
that instruction may be fetched, i ntei — 
mediate results may be maintained for 
subsequent modification, and final 
results may be temporarily held prior to 
placing them in storage. Stores caused 
by other CPUs and by channel programs do 
not necessarily affect these intermedi- 
ate results. 

Storage-operand references are of three 
types: fetches, stores, and updates. 



Storage-Operand Fetch References 



When the bytes of a storage operand 
participate in the instruction execution 
only as a source, the operand is called 
a fetch-type operand, and the reference 
to the location is called a storage- 
operand fetch reference. A fetch-type 
operand is identified in individual 
instruction definitions by indicating 
that the access exception is for fetch. 

All bits within a single byte of a fetch 
reference are accessed concurrently. 
When an operand consists of more than 
one byte, the bytes may be fetched from 
storage piecemeal, one byte at a time. 
Unless otherwise specified, the bytes 
are not necessarily fetched in any 
particular sequence. 

The storage-operand fetch references of 
one instruction occur after those of all 
preceding instructions and before those 
of subsequent instructions, as observed 
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by other CPUs and by channel programs. 
The operands of any one instruction are 
fetched in the sequence specified for 
that instruction. 



Storage-Operand Store References 



When the bytes of a storage operand 
participate in the instruction execution 
only as a destination, to the extent of 
being replaced by the result, the oper- 
and is called a store-type operand, and 
the reference to the location is called 
a storage-operand store reference. A 
store-type operand is identified in 
individual instruction definitions by 
indicating that the access exception is 
for store. 

All bits within a single byte of a store 
reference are accessed concurrently. 
When an operand consists of more than 
one byte, the bytes may be placed in 
storage piecemeal, one byte at a time. 
Unless otherwise specified, the bytes 
are not necessarily stored in any 
particular sequence. 

The CPU may delay placing results in 
storage. There is no defined limit on 
the length of time that results may 
remain pending before they are stored. 

Thi s delay does not affect the sequence 
in which results are placed in storage. 
The results of one instruction are 
placed in storage after the results of 
all preceding instructions have been 
placed in storage and before any results 
of the succeeding instructions sre 
stored, as observed by other CPUs and by 
channel programs. The results of any 
one instruction ar^t stored in the 
sequence specified for that instruction. 

The CPU does not fetch operancs or DAT- 
table entries from a storage location 
until all information destined for that 
location by the CPU has been stored. 
Prefetched instructions may appear to be 
updated before the information appears 
in storage. 

The stores are necessarily completed 
only as a result of a serializing opera- 
tion and before the CPU enters the 
stopped state. 



referred to as an update reference. 
Instructions such as MOVE ZONES, TRANS- 
LATE, OR (OC, 01), and ADD DECIMAL cause 
an update to the first-operand location. 
An update-type operand is identified in 
the individual instruction definition by 
indicating that the access exception is 
for both fetch and store. 
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For certain special instructions, the 
update reference is interlocked against 
certain accesses by other CPUs. Such an 
update reference is called an 
i nterlocked-update reference. The fetch 
and store accesses associated with an 
i nterlocked-update reference do not 
necessarily occur one immediately after 
the other, but all store accesses and 
the fetch and store accesses associated 
with i nterlocked-update references by 
other CPUs are prevented from occurring 
at the same location between the fetch 
and the store accesses of an 
i nterlocked-update reference. Accesses 
by channel programs may occur to the 
location during the interlock period. 

The storage-operand update references 
for the following instructions appear to 
be an i nterlocked-update reference as 
observed by other CPUs. The 
instructions TEST AND SET, COMPARE AND 
SWAP, and COMPARE DOUBLE AND SWAP 
perform an i nterlocked-update reference. 
On models in which the STORE CHARACTERS 
UNDER MASK instruction with a mask of 
zero fetches and stores the byte desig- 
nated by the second-operand address, the 
fetch and store accesses are an 
i nterlocked-update reference. 

Within the limitations of the above 
requirements, the fetch and store 
accesses associated with an update 
reference follow the same rules as the 
fetches and stores described in the 
previous sections. 



Storage-Operand Update References 



In some instructions, the storage- 
operand location participates both as a 
source and as a destination. In these 
cases, the reference to the location 
consists first in a fetch and subse- 
quently in a store. The operand is 
called an update-type operand, and the 
combination of the two accesses is 



Proarammi ng Notes 



When two CPUs attempt to update 
information at a common main- 
storage location by means of a 
noni nterlocked-update reference, it 
is possible for both CPUs to fetch 
the information and subsequently 
make the store access. The change 
made by the first CPU to store the 
result in such a case is lost. 
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Similarly, if one CPU updates the 
contents of a field by means of a 
noni nterlocked-update reference, 
but another CPU makes a store 
access to that field between the 
fetch and store parts of the update 
reference, the effect of the store 
is lost. If, instead of a store 
access, a CPU makes an 
i nterlocked-update reference to the 
common storage field between the 
fetch and store portions of a 
noni nterlocked-update reference due 
to another CPU, any change in the 
contents produced by the 
i nterlocked-update reference is 
lost. 



Execution of OR (OC) with the 
first- and second-operand 
fields coinciding. 

For those locations of the 
first operand of TRANSLATE 
where the argument and function 
values are the same. 



STORAGE-OPERAND CONSISTENCY 



Single-Access References 



The instructions TEST AND SET, 
COMPARE AND SWAP, and COMPARE 
DOUBLE AND SWAP facilitate updating 
of a common storage field by two or 
more CPUs. To ensure that no 
changes are lost, all CPUs must use 
an instruction providing an intei — 
locked-update reference. In 
addition, the program must ensure 
that channel programs do not store 
into the same storage location 
since such stores may occur between 
the fetch and store portions of an 
i nterlocked-update reference. 

Only those bytes which are included 
in the result field of both opei — 
ations are considered to be part of 
the common main-storage location. 
However, all bits within a common 
byte are considered to be common 
even if the bits modified by the 
two operations do not overlap. As 
an example, if (1) one CPU executes 
the instruction OR (OC) with a 
length of 1 and the value 80 hex in 
the second-operand location and 
(2) the other CPU executes AND (NO 
with a length of 1 and the value FE 
hex in the second-operand location, 
and (3) the first operand of both 
instructions is the same byte, then 
the result of one of the updates 
can be lost. 
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Depending on the model, an access 

to store information may be 

performed, for example, in the 
following cases: 

a. Execution of the OR instruction 
(01 or OC) with a second opei — 
and of all zeros. 



A fetch reference is said to be a 
single-access reference if the value is 
fetched in a single access to each byte 
of the data field. In the case of ovei — 
lapping operands, the location may be 
accessed once for each operand. A 
store-type reference is said to be a 
single-access reference if a single 
store access occurs to each byte 
location within the data field. An 
update reference is said to be single- 
access if both the fetch and store 
accesses are each single-access. 

Except for the accesses associated with 
multiple-access references and the 
stores associated with storage change 
and restoration for DAT-associated 
access exceptions, all storage-operand 
references are single-access references. 



Multiple- Access References 



I In some cases, multiple accesses may be 
made to all or some of the bytes of a 
storage operand. The following cases 
may involve multiple-access references: 

1. The storage operands of the follow- 
ing instructions: CONVERT TO BINA- 
RY, CONVERT TO DECIMAL, MOVE 
INVERSE, MOVE WITH OFFSET, PACK, 
TRANSLATE, TEST BLOCK, UNPACK, and 
UPDATE TREE. 

2. The stores into that portion of the 
first operand of MOVE LONG which is 
filled with padding bytes. 

I 3. The storage operands of the decimal 
i nstructi ons. 

4. The stores into a trace entry. 

5. The storage operands of vector- 
facility instructions. 

6. The stores associated with the 
stop-and-store-status and store- 
status-at-address SIGNAL PROCESSOR 
orders. 
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Uihen a storage-operand store reference 
to a location is not a single-access 
reference, the value placed at a byte 
location is not necessarily the same for 
each store access; thus, intermediate 
results in a single-byte location may be 
observed by other CPUs and by channel 
programs. 



Programmi ng Notes 
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When CPU instructions which make 
multiple-access references are used 
to modify storage locations being 
simultaneously accessed by another 
CPU or by a channel program, multi- 
ple store accesses to a single byte 
by the CPU may result in intermedi- 
ate values being observed by the 
other CPU or by the channel 
program. To avoid these intermedi- 
ate values (for example, when 
modifying a CCW chain), only 
instructions making single-access 
references should be used. 



Block-Concurrent References 



For some references, the accesses to all 
bytes within a halfword, word, or 
doubleword are specified to appear to be 
block-concurrent as observed by other 
CPUs. These accesses do not necessarily 
appear to channel programs to include 
more than a byte at a time. The half- 
word, word, or doubleword is referred to 
in this section as a block. When a 
fetch-type reference is specified to 
appear to be concurrent within a block, 
no store access to the block by another 
CPU is permitted during the time that 
bytes contained in the block are being 
fetched. Accesses to the bytes within 
the block by channel programs may occur 
between the fetches. When a store-type 
reference is specified to appear to be 
concurrent within a block, no access to 
the block, either fetch or store, is 
permitted by another CPU during the time 
that the bytes within the block are 
being stored. Accesses to the bytes in 
the block by channel programs may occur 
between the stores. 



Consi stencv Speci f ication 



For all instructions in the S format and 
RX format, with the exception of 
EXECUTE, CONVERT TO DECIMAL, CONVERT TO 
BINARY, and the I/O instructions, when 
the operand is addressed on a boundary 
which is integral to the size of the 
operand, the storage-operand references 
appear to be block-concurrent as 
observed by other CPUs. 

For the instructions COMPARE AND SWAP 
and COMPARE DOUBLE AND SWAP, all 
accesses to the storage operand appear 
to be block-concurrent as observed by 
other CPUs. 
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The instructions LOAD CONTROL and STORE 
CONTROL access the storage operand in a 
left-to-right direction, and all bytes 
accessed within each word appear to be 
accessed concurrently as observed by 
other CPUs. 

When destructive overlap does not exist, 
the operands of MOVE (MVC), MOVE WITH 
KEY, MOVE TO PRIMARY, and MOVE TO 
SECONDARY are accessed as follows: 

1. The first operand is accessed in a 
left-to-right direction, and all 
bytes accessed within a doubleword 
appear to be accessed concurrently 
as observed by other CPUs. 

2. The second operand is accessed left 
to right, and all bytes within a 
doubleword in the second operand 
that are moved into a single 
doubleword in the first operand 
appear to be fetched concurrently 
as observed by other CPUs. Thus, 
if the first and second operands 
begin on the same byte offset with- 
in a doubleword, the second operand 
appears to be fetched doubleword- 
concurrent. If the offsets within 
a doubleword differ by 4, the 
second operand appears to be 
fetched word-concurrent as observed 
by other CPUs. 

Destructive overlap is said to exist 
when the result location is used as a 
source after the result has been stored, 
assuming processing to be performed one 
byte at a time. 
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The operands for MOVE LONG appear to be 
accessed doubleword-concurrent as 
observed by other CPUs when all of the 
following are true: 

• Both operands start on doubleword 
boundaries and are an integral 
number of doublewords in length. 

• The operands do not overlap. 

• The nonpadding part of the opera- 
tion is being executed. 

The operands for COMPARE LOGICAL LONG 
appear to be accessed doubleword- 
concurrent as observed by other CPUs 
when both operands start on doubleword 
boundaries and sre an integral number of 
doublewords in length. 

For EXCLUSIVE OR (XC), the operands are 
processed in a left-to-right direction, 
and, when the first and second operands 
coincide, all bytes accessed within a 
doubleword appear to be accessed concur- 
rently as observed by other CPUs. 



Programmi ng Note 



In the case of EXCLUSIVE OR (XC) desig- 
nating operands which coincide exactly, 
the bytes within the field may appear to 
be accessed as many as three times, by 
two fetches and one store: once as the 
fetch portion of the first operand 
update, once as the second-operand 
fetch, and then once as the store 
portion of the first-operand update. 
Each of the three accesses appears to be 
doubleword-concurrent as observed by 
other CPUs, but the three accesses do 
not necessari ly appear to occur one 
immediately after the other. One or 
both fetch accesses may be omitted since 
the instruction can be completed without 
fetching the operands. 



RELATION BETWEEN OPERAND ACCESSES 



As observed by other CPUs and by channel 
programs, storage-operand fetches asso- 
ciated with one instruction execution 
appear to precede all storage-operand 
references for conceptually subsequent 
instructions. A storage-operand store 
specified by one instruction appears to 
precede all storage-operand stores spec- 
ified by conceptually subsequent 
instructions, but it does not necessai — 
i ly precede storage-operand fetches 
specified by conceptually subsequent 
instructions. However, a storage- 
operand store appears to precede a 
conceptually subsequent storage-operand 
fetch from the same main-storage 
locati on. 



When an instruction has two storage 
operands both of which cause fetch 
references, it is unpredictable which 
operand is fetched first, or how much of 
one operand i s fetched before the other 
operand is fetched. When the two oper- 
ands overlap, the common locations may 
be fetched independently for each opei — 
and. 

When an instruction has two storage 
operands the first of which causes a 
store and the second a fetch reference, 
it is unpredictable how much of the 
second operand i s fetched before the 
results are stored. In the case of 
destructively overlapping operands, the 
portion of the second operand which is 
common to the first is not necessarily 
fetched from storage. 

When an instruction has two storage 
operands the first of which causes an 
update reference and the second a fetch 
reference, it is unpredictable which 
operand is fetched first, or how much of 
one operand is fetched before the other 
operand is fetched- Similarly, it is 
unpredictable how much of the result is 
processed before it is returned to stor- 
age. In the case of destructively 
overlapping operands, the portion of the 
second operand which is common to the 
first is not necessarily fetched from 
storage. 



Programmi ng Note 



The independent fetching of a single 
location for each of two operands may 
affect the program execution in the 
following situation. 
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OTHER STORAGE REFERENCES 



The restart, program, supervisor-call, 
external, input/output, and machine- 
check PSWs appear to be accessed 
doubleword-concurrent as observed by 
other CPUs. These references appear to 
occur after the conceptually previous 
unit of operation and before the concep- 
tually subsequent unit of operation. 
The relationship between the new-PSW 
fetch, the old-PSW store, and the 
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SERIALIZATION 
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CPU SERIALIZATION 
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Serialization is performed by CPU reset, 
all interruptions, and by the execution 
of the following instructions: 

• The general instructions BRANCH ON 
CONDITION (BCR) with the M, and R a 
field containing all ones and all 
zeros, respectively, and COMPARE 
AND SWAP, COMPARE DOUBLE AND SWAP, 
STORE CLOCK, SUPERVISOR CALL, and 
TEST AND SET. 



LOAD PSW 
EXTENDED. 



and SET STORAGE KEY 



All I/O instructions. 

PURGE TLB and SET PREFIX, which 
also cause the translation- 



lookaside buffer to be cleared of 
entri es. 

SIGNAL PROCESSOR. 

INVALIDATE PAGE TABLE ENTRY. 

TEST BLOCK. 

MOVE TO PRIMARY, MOVE TO SECONDARY, 
PROGRAM CALL, PROGRAM TRANSFER, SET 
ADDRESS SPACE CONTROL, and SET 
SECONDARY ASN. 

• The three trace functions — branch 
tracing, ASN tracing, and explicit 
tracing -- cause serialization to 
be performed before the trace 
action and after completion of the 
trace action. 

The sequence of events associated with a 
serializing operation is as follows: 

1. All conceptually previous storage 
accesses by the CPU are completed 
as observed by other CPUs and by 
channel programs. This includes 
all conceptually previous stores 
and changes to the storage keys. 

2. The normal function associated with 
the serializing operation is 
performed. In the case of instruc- 
tion execution, operands are 
fetched, and the storing of results 
is completed. The exceptions are 
LOAD PSW and SET PREFIX, in which 
the operand may be fetched before 
previous stores have been 
completed, and interruptions, in 
which the interruption code and 
associated fields may be stored 
prior to the serialization. The 
fetching of the serializing 
instruction occurs before the 
execution of the instruction and 
may precede the execution of previ- 
ous instructions, but may not 
precede the completion of any 
previous serializing operation. In 
the case of an interruption, the 
old PSW, the interruption code, and 
other information, if any, are 
stored, and the new PSW is fetched, 
but not necessarily in that 
sequence. 

3. Finally, instruction fetch and 
operand accesses for conceptually 
subsequent operations may begin. 

A serializing function affects the 
sequence of storage accesses that are 
under the control of the CPU in which 
the serializing function takes place. 
It does not affect the sequence of stor- 
age accesses under the control of other 
CPUs and of channel programs. 



Chapter 5. Program Execution 5-31 



Programming Notes 



1. The following are some effects of a 
serializing operation: 

a. When the execution of an 
instruction changes the 
contents of a storage location 
that is used as a source of a 
following instruction and when 
different addresses &re used to 
designate the same absolute 
location for storing the result 
and fetching the instruction* a 
serializing operation following 
the change ensures that the 
modified instruction is 
executed. 

b. When a serializing operation 
takes place, other CPUs and 
channel programs observe 
instruction and operand fetch- 
ing and result storing to take 
place in the sequence estab- 
lished by the serializing 
operation. 

2. Storing into a location from which 
a serializing instruction is 
fetched does not necessarily affect 
the execution of the serializing 
instruction unless a serializing 
function has been performed after 
the storing and before the 
execution of the serializing 
i nstruction. 



1. All storage accesses and storage- 
key accesses by the channel program 
follow initiation of the execution 
of START SUBCHANNEL, or, if 
suspended, RESUME SUBCHANNEL, as 
observed by CPUs and by other chan- 
nel programs. This includes all 
accesses for the CCWs, IDAWs, and 
data. 

2. All storage accesses and storage- 
key accesses by the channel program 
are completed, as observed by CPUs 
and by other channel programs, 
before the subchannel status indi- 
cating status-pending with primary 
status is made available to any 
CPU. 

3. If a CCW contains a PCI flag or a 
suspend flag which is one, all 
storage accesses and storage-key 
accesses due to CCWs preceding it 
in the CCW chain are completed, as 
observed by CPUs and by other chan- 
nel programs, before the subchannel 
status indicating status-pending 
with intermediate status (PCI or 
suspended) is made available to any 
CPU. 

The serialization of a channel program 
does not affect the sequence of storage 
accesses or storage-key accesses caused 
by other channel programs or by another 
CPU program. 



CHANNEL-PROGRAM SERIALIZATION 



Serialization of 
occurs as follows: 



a channel program 



4 
\ 
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ThQ interrupt 
CPU to change 
condi tions 
conf i guration 
or within th 
fast respons 
priority and 
the type of 
conditions ar 
external , in 
program, rest 



ion mechanism permits the 
its state as a result of 

external to the 

, uii thin the configuration, 

e CPU itself. To permit 

e to conditions of high 

immediate recognition of 

condition, interruption 
e grouped into six classes: 
put/output, machine check, 
art, and supervisor call. 



INTERRUPTION ACTION 



An interruption consists in storing the 
current PSW as an old PSW, storing 
information identifying the cause of the 
interruption, and fetching a new PSW. 
Processing resumes as specified by the 
new PSW. 



The old PSW stored 
normally contains 
instruction that 



on an interruption 

the addres? of the 

would ha ye been 



executed next had the interruption not 
occurred, thus permitting resumption of 
the interrupted program. For program 
and supervisor-call interruptions, the 
information stored also contains a code 
that identifies the length of the last- 
executed instruction, thus permitting 
the program to respond to the cause of 
the interruption. In the case of some 
program conditions for which the normal 
response is reexecution of the instruc- 
tion causing the interruption, the 
instruction address directly identifies 
the instruction last executed. 

Except for restart, an interruption can 
occur only when the CPU is in the oper- 
ating state. The restart interruption 
can occur with the CPU in either the 
stopped or operating state. 

The details of source identification, 
location determination, and instruction 
execution are explained in later 
sections and are summarized in the 
figure "Interruption Action. n 



V 



m 

1 



6-2 370-XA Principles of Operation 













Mask Bits 
















in Ctrl 




Execution of 










PSW- 


Regi sters 




Instructi on 


Source 


Interruption 




Mask 




ILC 


Identi f i ed 


Identi f i cati on 




Code 




Bits 


Reg, Bit 


Set 


by Old PSW 


MACHINE CHECK 


Locations 232-239 1 












(old PSW 48, 
















new PSW 112) 
















Exigent condition 








13 




u 


terminated or 
nulli f i ed 2 


Repressible cond 








13 


14, 3-7 


u 


unaffected 2 


SUPERVISOR CALL 


Locations 138-139 












(old PSW 32, 
















new PSW 96) 
















Instruction bits 


00000000 


5SSS55SS 








1,2 


completed 


PROGRAM 


Locations 142-143 












(old PSW 40, 
new PSW 104) 

Operation 
















Binary 


Hex 3 






1,2,3 


suppressed 


00000000 


P0000001 


0001 


Privileged oper 


00000000 


P0000010 


0002 






2,3 


suppressed 


Execute 
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Source 
Identi f ication 



Interruption 
Code 



PSW- 
Mask 
Bits 



Mask Bits 
in Ctrl 
Regi sters 

Reg, Bit 



ILC 
Set 



Execution of 
Instruction 
Identi f i ed 
by Old PSW 



EXTERNAL 

(old PSW 24, 
new PSW 88) 

Interrupt key 
Malfunction alert 
Emergency signal 
External call 
TOD-clock sync chk 
Clock comparator 
CPU timer 
Service signal 



Locations 134-135 



Bi nary 



00000000 
00010010 
00010010 
00010010 
00010000 
00010000 
00010000 
00100100 



01000000 
00000000 
00000001 
00000010 
00000011 
00000100 
00000101 
00000001 



Hex ; 



0040 
1200 
1201 
1202 
1003 
1004 
1005 
2401 



0, 25 

0, 16 

0, 17 

0, 18 

0, 19 

0, 20 

0, 21 

0, 22 
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unaffected 


u 


unaffected 


u 


unaffected 


u 


unaffected 


u 


unaffected 


u 


unaffected 


u 


unaffected 


u 


unaffected 



INPUT/OUTPUT 
(old PSW 56, 
new PSW 120) 

I/O- i nterrupt i on 
subclass 



Locations 184-191 



6, 0-7 



-77 



unaffected 



RESTART 

(old PSW 8, 
new PSW 0) 

Restart key 



None 



unaffected 



Explanati on i 



Locations for the old PSWs, new PSWs, and interruption codes are real locations. 
3 Additional masks in control register 9, bit positions 16-31, provide detailed 

control over the source of PER general-register-alteration events which are 

masked by control register 9, bit 3. 

1 A model-independent machine-check interruption code of 64 bits is stored at 
real locations 232-239. 

2 The effect of the machine-check condition is indicated by bits in 
check interruption code. The setting of these bits indicates the 



the machine- 
extent of 



the damage and whether the unit of operation is nullified, terminated, or 
unaffected. 

The interruption code in the column labeled "Hex" is the hex code for the 
basic interruption; this code does not show the effects of concurrent inter- 
ruption conditions represented by n, p, or x in the column labeled "Binary." 
Vector-operation and unnormali zed-operand exceptions are associated with 
the vector facility. "Inhibited" is a type of ending which occurs only for 
instructions associated w:th the vector facility. These are described in 
the publication IBM Svstem/370 Vector Operations , SA22-7125. 
When the interruption code indicates a PER event, an ILC of may be stored 
only when bits 8-15 of the interruption code are 10000110 (PER, specifi- 
cati on) . 

The unit of operation is completed, unless a program exception concurrently 
indicated causes the unit of operation to be inhibited, nullified, suppressed, 
or terminated. 

Bits 0-7 of control register 6 provide detailed masking of I/O-interrupti on 
subclasses 0-7 respectively. 

A possible nonzero code indicating another concurrent program-interruption 
condi tion 

If one, the bit indicates a concurrent PER-event interruption condition. 
Bits of the I field of SUPERVISOR CALL. 
Not stored. 

Exception-extension code. This field is described in the publication IBM 
Svstem/370 Vector Qperati ons , SA22-7125. This field is set to zero except by 
vector instructions. 
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INTERRUPTION CODE 



The six classes of interruptions 
(external, I/O, machine check, program, 
restart, and supervisor call) are 
distinguished by the storage locations 
at which the old PSW is stored and from 
which the new PSW is fetched. For most 
classes, the causes are further identi- 
fied by an interruption code and, for 
some classes, by additional information 
placed in permanently assigned real 
storage locations during the intei — 
ruption. (See also the section 
"Assigned Storage Locations" in Chapter 
3, "Storage.") For external, program, 
and supervisor-call interruptions, the 
interruption code consists of 16 bits. 

For external interruptions, the inter- 
ruption code is stored at real locations 
134-135. A parameter may be stored at 
real locations 128-131, or a CPU address 
may be stored at real locations 132-133. 

For I/O interruptions, the 1/0- 
interruption code is stored at real 
locations 184-191. The I/O-i nterruption 
code consists of a 32-bit subsystem- 
identification word and a 32-bit inter- 
ruption parameter. 
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machine-check interruptions, the 
rruption code consists of 64 bits 
is stored at real locations 232-239. 
tional information for identifying 
cause of the interruption and for 
vering the state of the machine may 
provided by the contents of the 
ine-check failing-storage address 
the contents of the fixed-logout and 
ine-check-save areas. (See Chapter 
"Machine-Check Handling.") 



program inter 
ion code is st 
143, and the i 
tored in bit 

location 141. 

be provided 
slati on-except 
tor-class numb 
and PER addr 
eal locations 



ruptions 
ored at 
nstructi 
posi ti on 
Furth 
in the 
ion i 
er, moni 
ess, wh 
144-159. 



, the in 
real locat 
on-length 
s 5 and 
er informa 

form of 
denti f icat 
tor code, 
ich are st 



tei — 
i ons 
code 
6 of 
tion 

the 
ion, 

PER 
ored 



for some program interruptions. When a 
mask bit is one, the CPU is enabled for 
the corresponding class of 
interruptions, and these interruptions 
can occur. 

When a mask bit is zero, the CPU is 
disabled for the corresponding inter- 
ruptions. The conditions that cause I/O 
interruptions remain pending. 
External-interruption conditions either 
remain pending or persist until the 
cause is removed. Machine-check- 
interruption conditions, depending on 
the type, are ignored, remain pending, 
or cause the CPU to enter the check-stop 
state. The disallowed program- 
interruption conditions are ignored, 
except that some causes are indicated 
also by the setting of the condition 
code. The setting of the significance 
and exponent-underflow program-mask bits 
affects the manner in which floating- 
point operations are completed when the 
corresponding condition occurs. 

The CPU is always enabled for program 
interruptions for which mask bits are 
not provided, as well as the 
supervisor-call and restart inter- 
ruptions. 



or di sallow all 
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The mask bits may allow 
interruptions within the 
may selectively allow or 
ruptions for particular 
control may be provided 
the PSW that are assigned to particular 
causes, such as the bits assigned to the 
four maskable program-interruption 
conditions. Alternatively, there may be 
a hierarchy of masks, where a mask bit 
in the PSW controls all interruptions 
within a type, and mask bits in a 
control register provide more detailed 
control over the sources. 

When the mask bit is one, the CPU is 
enabled for the corresponding interrup- 
tions. When the mask bit is zero, these 
interruptions are disallowed. Interrup- 
tions that are controlled by a hierarchy 
of masks are allowed only when all 
controlling mask bits are ones. 



For restart interruptions, 
ruption code is stored. 



no inter- 



For supervisor-call interruptions, the 
interruption code is stored at real 
locations 138-139, and the instruction- 
length code is stored in bit positions 5 
and 6 of real location 137. 



ENABLING AND DISABLING 



By means of mask bits in the current PSW 
and in control registers, the CPU may be 
enabled or disabled for all external, 
I/O, and machine-check interruptions and 



Programmi ng Notes 



Mask bits in the PSW provide a 
means of disallowing all maskable 
interruptions; thus, subsequent 
interruptions can be disallowed by 
the new PSW introduced by an inter- 
ruption. Furthermore, the mask 
bits can be used to establish a 
hierarchy of interruption priori- 
ties, where a condition in one 
class can interrupt the program 
handling a condition in another 
class but not vice versa. To 
prevent an interruption-handling 
routine from being interrupted 
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before the necessary housekeeping 
steps are performed* the new PSUI 
must disable the CPU for further 
interruptions within the same class 
or within a class of lower 
pri ori ty. 



Because the mask bit 
registers are not cha 
of the interruption 
these masks cannot 
prevent an interruptio 
after a previous int 
the same class. The 
control registers pro 
for selectively enabl 
for some sources and 
for others within the 



s in control 
nged as part 
procedure, 

be used to 
n immediately 
erruption in 
mask bits in 
vide a means 
ing the CPU 

disabling it 
same class. 



HANDLING OF FLOATING INTERRUPTION CONDI- 
TIONS 



An interruption condition which can be 
presented to any CPU in the configura- 
tion is called a floating interruption 
condition. The condition is presented 
to the first CPU in the configuration 
which is enabled for the corresponding 
interruption and which can accept the 
interruption, and then the condition is 
cleared and not presented to any other 
CPU in the configuration. A CPU cannot 
accept the interruption when it is in 
the check-stop state, has an invalid 
prefix, is in a string of program inter- 
ruptions due to a specification 
exception of the type which is recog- 
nized early, or is in the stopped state. 
However, a CPU with the rate control set 
to instruction step can accept the 
interruption when the start key is acti- 
vated. 

Service signal* I/O, and certain 
machine-check conditions are floating 
interruption conditions. 



INSTRUCTION-LENGTH CODE 



The instruction-length code (ILC) occu- 
pies two bit positions and provides the 
length of the last instruction executed. 
It permits identifying the instruction 
causing the interruption when the 
instruction address in the old PSW 
designates the next sequential instruc- 
tion. The ILC is provided also by the 
BRANCH AND LINK instructions in the 
24-bit addressing mode. 

The ILC for program and supervisor-call 
interruptions is stored in bit positions 
5 and 6 of the bytes at real locations 
141 and 137, respectively. For 
external, I/O, machine-check, and 
restart interruptions, the ILC is not 
stored since it cannot be related to the 
length of the last-executed instruction. 



For supervisor-call and program inter- 
ruptions, a nonzero ILC identifies in 
halfwords the length of the instruction 
that was last executed. Whenever an 
instruction is executed by means of 
EXECUTE, instruction-length code 2 is 
set to indicate the length of EXECUTE 
and not that of the target instruction. 

The value of a nonzero instruction- 
length code is related to the leftmost 
two bits of the instruction. The value 
does not depend on whether the operation 
code is assigned or on whether the 
instruction is installed. The following 
table summarizes the meaning of the 
instruction-length code: 



ILC 


Instr 
Bits 
0-1 


Instructi on 
Length 


Decimal 


Binary 



1 
2 
2 
3 


00 
01 
10 
10 
11 


00 
01 
10 
11 


Not avai lable 
One halfword 
Two halfwords 
Two halfwords 
Three halfwords 



Zero ILC 



Instruction-length code 0, after a 
program interruption, indicates that the 
instruction address stored in the old 
PSW does not identify the instruction 
causing the interruption. 



An ILC of occurs 
exception due to a 
recognized as part 
recognition and the 
duced by LOAD PSW 
(See the section " 
with the PSW" late 
In the case of LOAD 
address of LOAD PSW 
replaced by the in 
the new PSW. When 
introduced by an i 
format error cannot 
i nstruction. 



when a specification 

PSW-format error is 

of early exception 

PSW has been intro- 

or an interruption. 

Exceptions Associated 

r in this chapter.) 

PSW, the instruction 

or EXECUTE has been 

struction address of 

the invalid PSW is 

nterruption, the PSW- 

be attributed to an 



In the case of LOAD PSW and the 
supervisor-call interruption, a PER 
event may be indicated concurrently with 
a specification exception having an ILC 
of 0. 



ILC on Instructi on-Fetchi ng Excepti ons 



When a program interruption occurs 
because of an exception that prohibits 
access to the instruction, the 
instruction-length code cannot be set on 
the basis of the first two bits of the 
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instruction. As far as the significance 
of the ILC for this case is concerned, 
the following two situations are distin- 
gui shed: 

1. When an odd instruction address 
causes a specification exception to 
be recognized or when an 
addressing, protection, or 
translati on-speci f i cat i on except i on 
is encountered on fetching an 
instruction, the ILC is set to 1, 
2, or 3, indicating the multiple of 
2 by which the instruction address 
has been incremented. It is unpre- 
dictable whether the instruction 
address is incremented 
6. By reducing the 
address in the old 
number of halfword 
cated in the ILC, 



by 2, 4, or 
i nstructi on 

PSW by the 
locations indi- 
the instruction 



address originally appearing in 
PSW may be obtained. 



the 



When a segment-translation or 
page-translation exception is 
recognized while fetching an 
instruction, including the target 
instruction of EXECUTE, the ILC is 
arbitrarily set to 1, 2, or 3. In 
this case, the operation is nulli- 
fied, and the instruction address 
is not incremented. 



is not necessarily related to 

t two bits of the instruction 

first halfword of an instruc- 

be fetched but an access excep- 
recognized on fetching the 
r third halfword. The ILC may 
trarily set to 1, 2, or 3 in 
ses. The instruction address is 
t updated, as described in situ- 

and 2 above. 



When any exceptions other than segment 
translation or page translation are 
encountered on fetching the target 
instruction of EXECUTE, the ILC is 2. 



The ILC 


the firs 


when the 


tion can 


tion is 


second o 


be arbi 


these ca 


or i s no 


ations 1 



Programming Notes 



1. A nonzero instruction-length code 
for a program interruption indi- 
cates the number of halfword 
locations by which the instruction 
address in the program old PSW must 
be reduced to obtain the instruc- 
tion address of the last 
instruction executed, unless one of 
the following situations exists: 



The interruption 
an exception 
null i f i cati on. 



i s caused 
resulti ng 



by 
i n 



b. An interruption for a PER event 
occurs before the execution of 
an i nterrupti ble instruction is 
completed, and no other 



program-interruption condition 
is indicated concurrently. 

c. The interruption is caused by a 
PER event due to LOAD PSW or a 
branch or linkage instruction, 
including SUPERVISOR CALL (but 
not including MONITOR CALL). 

d. The interruption is caused by 
an access exception encountered 
in fetching an instruction, and 
the instruction address has 
been introduced into the PSW by 
a means other than sequential 
operation (by a branch instruc- 
tion, LOAD PSW, an 
interruption, or conclusion of 
an IPL sequence) . 

e. The interruption is caused by a 
specification exception because 
of an odd instruction address. 

f. The interruption is caused by 
an early specification excep- 
tion or by an access exception 
encountered in fetching an 
instruction, and changes have 
been made to a parameter that 
controls the relation between 
instruction addresses and real 
addresses. The relation 
between instruction addresses 
and real addresses can be 
changed without introducing an 
entire new PSW by switching 
from the real mode, primary- 
space mode, or secondary-space 
mode to a different mode, or by 
changing one or more of the 
translation parameters in 
control registers 1 and 7. The 
early specification exception 
can be caused by executing 
STORE THEN OR SYSTEM MASK or 
SET SYSTEM MASK, which switches 
to or from the real mode while 
introducing invalid values in 
bit positions 0-7 of the PSW. 

For situations a and b above, the 
instruction address in the PSW is 
not incremented, and the instruc- 
tion designated by the instruction 
address i s the same as the last one 
executed. These situations ar& the 
only ones in which the instruction 
address in the old PSW identifies 
the instruction causing the excep- 
tion. 

For situations c, d, and e, the 
instruction address has been 
replaced as part of the operation, 
and the address of the last 
instruction executed cannot be 
calculated using the one appearing 
in the program old PSW. 

For situation f, the instruction 
address in the PSW has not been 
replaced, but the corresponding 
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real address after the change may 
be different. 

The instruction-length cede (ILC) 
is redundant when a PER event is 
indicated since the PER address in 
the word at real location 152 iden- 
tifies the instruction causing the 
interruption (or the EXECUTE 
instruction, as appropriate). 
Similarly, the ILC is redundant 
when the operation is nullified, 
since in this case the instruction 
address in the PSW is not incre- 
mented. If the ILC value is 
required in this case, it can be 
derived from the operation code of 
the instruction identified by the 
old PSW. 



the above error conditions is introduced 
by execution of SET SYSTEM MASK or STORE 
THEN OR SYSTEM MASK, the instruction- 
length code is set to 2, and the 
instruction address is incremented by 4. 
The PSW containing the invalid value 
introduced into the system-mask field is 
stored as the old PSW. 

When a PSW with one of the above error 
conditions is introduced during initial 
program loading, the loading sequence is 
not completed, and the load indicator 
remains on. 



Late Exception Recognition 



EXCEPTIONS ASSOCIATED WITH THE PSW 



For the following conditions, the excep- 
tion is recognized as part of the 
execution of the next instruction: 



Exceptions associated with erroneous 
information in the current PSW may be 
recognized when the information is 
introduced into the PSW or may be recog- 
nized as part of the execution of the 
next instruction. Errors in the PSW 
which are specification-exception condi- 
tions are called PSW-format errors. 



Early Excepti on Recogni ti on 



For the following error conditions, a 
program interruption for a specification 
exception occurs immediately after the 
PSW becomes active: 



• A one is introduced into an unas- 
signed bit position of the PSW 
(that is, any of bit positions 0, 
2-4, 17, or 24-31). 

• A zero is introduced into bit posi- 
tion 32 of the PSW, but bits 33-39 
are not all zeros. 

• A zero is introduced into bit posi- 
tion 12 of the PSW. 

The interruption occurs regardless of 
whether the wait state is specified. If 
the invalid PSW causes the CPU to become 
enabled for a pending I/O, external, or 
machine-check interruption, the program 
interruption occurs instead, and the 
pending interruption is subject to the 
mask bits of the new PSW introduced by 
the program interruption. 



When the execution of 
interruption introduces 
of the above error 
instruction-length code 
the newly introduced 
unmodified as th«s old 



LOAD PSW or an 

a PSW with one 

conditions, the 

is set to 0, and 

PSW is stored 

PSW. When one of 



• A specification exception is recog- 
nized due to an odd instruction 
address in the PSW (PSW bit 63 is 
one) . 

• An access exception (addressing, 
page-translation, protection, seg- 
ment-translation, or translation- 
specification) is associated with 
the location designated by the 
instruction address or with the 
location of the second or third 
halfword of the instruction start- 
ing at the designated instruction 
address. 

The instruction-length code and instruc- 
tion address stored in the program old 
PSW under these conditions are discussed 
in the section "ILC on Instruction- 
Fetching Exceptions" in this chapter. 



If an I/O, 
interruptio 
the PSW cau 
that condit 
ruption oc 
inspected 
recogni zed 
ifying the 
for except 
late. 



external, 
n condition 
ses the CPU 
ion, the cor 



curs, 
for 
late, 
wai t 
ions 



and 
except 

Simi 1 
state 
which 



or machine-check- 
is pending and 
to be enabled for 
responding intei — 
the PSW is not 
ions which are 
arly, a PSW spec- 
is not inspected 
are recognized 



Programming Notes 



1. The execution of LOAD ADDRESS SPACE 
PARAMETERS, LOAD PSW, PROGRAM CALL, 
PROGRAM TRANSFER, SET PREFIX, SET 
SECONDARY ASN, SET SYSTEM MASK, 
STORE THEN AND SYSTEM MASK, and 
STORE THEN OR SYSTEM MASK is 
suppressed on an addressing or 
protection exception, and hence the 
program old PSW provides informa- 
tion concerning the program causing 
the exception. 
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Uhen the first halfword of an 
instruction can be fetched but an 
access exception is recognized on 
fetching the second or third half- 
word, the ILC is not necessarily 
related to the operation code. 

If the new PSW introduced by an 
interruption contains a PSW-format 
error, a string of interruptions 
may occur. (See the section "Pri- 
ority of Interruptions" in this 
chapter. ) 



EXTERNAL INTERRUPTION 



The external interruption provides a 
means by which the CPU responds to vari- 
ous signals originating from either 
inside or outside the configuration. 

An external interruption causes the old 
PSW to be stored at real location 24 and 
a new PSW to be fetched from real 
location 88. 

The source of the interruption is iden- 
tified in the interruption code which is 
stored at real locations 134-135. The 
instruction-length code is not stored. 

Additionally, for the malfunction-alert, 
emergency-signal, and external-call 
conditions, a 16-bit CPU address is 
associated with the source of the inter- 
ruption and is stored at real locations 
132-133. When the CPU address is 
stored, bit 6 of the interruption code 
is set to one. For all other 
conditions, no CPU address is stored, 
bit 6 of the interruption code is set to 
zero, and zeros are stored at real 
locations 132-133. 

For the service-signal interruption, a 
32-bit parameter is associated with the 
interruption and is stored at real 
locations 128-131. Bit 2 of the 
external-interruption code indicates 
that a parameter has been stored. When 
bit 2 is zero, the contents of real 
locations 128-131 remain unchanged. 

External-interruption conditions are of 
two types: those for which an 
interruption-request condition is held 
pending, and those for which the condi- 
tion directly requests the interruption. 
Clock comparator, CPU timer, and TOD- 
clock sync check are conditions which 
directly request external interruptions. 
If a condition which directly requests 
an external interruption is removed 
before the request is honored, the 
request does not remain pending, and no 
interruption occurs. Conversely, the 
request is not cleared by the inter- 
ruption, and if the condition persists, 
more than one interruption may result 
from a single occurrence of the condi- 
ti on. 



When several interruption requests for a 
single source are generated before the 
interruption occurs, and the inter- 
ruption condition is of the type which 
is held pending, only one request for 
that source is preserved and remains 
pendi ng. 

An external interruption for a partic- 
ular source can occur only when the CPU 
is enabled for interruption by that 
source. The external interruption 
occurs at the completion of a unit of 
operation. The external mask, PSW bit 
7, and external subclass-mask bits in 
control register control whether the 
CPU is enabled for a particular source. 
Each source for an external interruption 
has a subclass-mask bit assigned to it, 
and the source can cause an interruption 
only when the external-mask bit is one 
and the corresponding subclass-mask bit 
is one. 

When the CPU becomes enabled for a pend- 
ing external-interruption condition, the 
interruption occurs at the completion of 
the instruction execution or intei — 
ruption that causes the enabling. 

More than one source may present a 
request for an external interruption at 
the same time. When the CPU becomes 
enabled for more than one concurrently 
pending request, the interruption occurs 
for the pending condition or conditions 
having the highest priority. 

The priorities for external-interruption 
requests in descending order are as 
follows: 

Interrupt key 
Malfunction alert 
Emergency signal 
External call 
TOD-clock sync check 
Clock comparator 
CPU timer 
Service signal 

All requests are honored one at a time. 
When more than one emergency-signal 
request exists at a time or when more 
than one malfunction-alert request 
exists at a time, the request associated 
with the smallest CPU address is honored 
first. 



CLOCK COMPARATOR 



An interruption request for the clock 
comparator exists whenever either of the 
following conditions is met: 

1. The TOD clock is in the set or 
not-set state, and the value of the 
clock comparator is less than the 
value in the compared portion of 
the TOD clock, both compare values 
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being considered unsigned binary 
integers. 



2. The TOD clock is in the 
not-operational state. 



error or 



If the condition responsible for the 
request is removed before the request is 
honored, the request does not remain 
pending, and no interruption occurs. 
Conversely, the request is not cleared 
by the interruption, and, if the condi- 
tion persists, more than one 
interruption may result from a single 
occurrence of the condition. 

When the TOD clock accessed by a CPU is 
set or changes state, interruption 
conditions, if any, that are due to the 
clock comparator may or may not be 
recognized for up to 1.048576 seconds 
after the change. 

The subclass-mask bit is in bit position 
20 of control register 0. This bit is 
initialized to zero. 



The clock-comparator condition is 
cated by an external-interruption 
of 1004 hex. 



CPU TIMER 



indi- 
code 



An interruption request 
timer exists whenever 
value is negative (bit 
timer is one). If the 
positive before the reque 
the request does not remai 
no interruption occurs. C 
request is not cleared 
ruption, and, if the condi 
more than one interrupti 
from a single occurrence 
ti on. 



for the CPU 
the CPU-timer 
of the CPU 
value is made 
st is honored, 
n pending, and 
onversely, the 
by the intei — 
tion persists, 
on may occur 
of the condi - 



When the TOD clock accessed by a CPU i s 
set or changes state, interruption 
conditions, if any, that are due to the 
CPU timer may or may not be recognized 
for up to 1.048576 seconds after the 
change. 

The subclass-mask bit is in bit position 
21 of control register 0. This bit is 
initialized to zero. 

The CPU-timer condition is indicated by 
an external-interruption code of 1005 
hex. 



EMERGENCY SIGNAL 



An interruption request for an emergency 
signal is generated when the CPU accepts 
the emergency-signal order specified by 
a SIGNAL PROCESSOR instruction address- 
ing this CPU. The instruction may have 



been executed by this CPU or by another 
CPU in the configuration. The request 
is preserved and remains pending in the 
receiving CPU until it is cleared. The 
pending request is cleared when it caus- 
es an interruption and by CPU reset. 

Facilities are provided for holding a 
separate emergency-signal request pend- 
ing in the receiving CPU for each CPU in 
the configuration, including the receiv- 
ing CPU itself. 

The subclass-mask bit is in bit position 
17 of control register 0. This bit is 
initialized to zero. 

The emergency-signal condition is indi- 
cated by an external-interruption code 
of 1201 hex. The address of the CPU 
that executed the SIGNAL PROCESSOR 
instruction is stored at real locations 
132-133. 



EXTERNAL CALL 



An interruption reque 
call is generated wh 
the external-call or 
SIGNAL PROCESSOR ins 
this CPU. The instru 
executed by this CPU 
in the configuration 
preserved and remai 
receiving CPU until i 
pending request is cl 
es an interruption an 



st for an external 
en the CPU accepts 
der specified by a 
truction addressing 
ction may have been 
or by another CPU 
The request i s 
ns pending in the 
t is cleared. The 
eared when it caus- 
d by CPU reset. 



Only one external-call request, along 
with the processor address, may be held 
pending in a CPU at a time. 

The subclass-mask bit is in bit position 
18 of control register 0. This bit is 
initialized to zero. 

The external-call condition is indicated 
by an external-interruption code of 1202 
hex. The address of the CPU that 
executed the SIGNAL PROCESSOR instruc- 
tion is stored at real locations 
132-133. 



INTERRUPT KEY 



An interruption request for the inter- 
rupt key is generated when the operator 
activates that key. The request is 
preserved and remains pending in the CPU 
until it is cleared. The pending 
request is cleared when it causes an 
interruption and by CPU reset. 

When the interrupt key is activated 
while the CPU is in the load state, it 
depends on the model whether an intei — 
ruption request is generated or the 
condition is lost. 
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The subclass-mask bit is in bit position 
25 of control register 0. This bit is 
initialized to one. 

The i nterrupt-key condition is indicated 
by an external-interruption code of 0040 
hex. 



MALFUNCTION ALERT 



An interruption request for a malfunc- 
tion alert is generated when another CPU 
in the configuration enters the check- 
stop state or loses power. The request 
is preserved and remains pending in the 
receiving CPU until it is cleared. The 
pending request is cleared when it caus- 
es an interruption and by CPU reset. 

Facilities are provided for holding a 
separate malfunction-alert request pend- 
ing in the receiving CPU for each of the 
other CPUs in the configuration. 
Removal of a CPU from the configuration 
does not generate a malfunction-alert 
condi ti on. 



The subclass-mask bit is in 
16 of control register 0. 
initialized to zero. 



bi t posi tion 
Thi s bi t i s 



The malfunction-alert condition is indi- 
cated by an external-interruption code 
of 1200 hex. The address of the CPU 
that generated the condition is stored 
at real locations 132-133. 



SERVICE SIGNAL 



An interruption request 
signal is generated upon 
of certain configurati 
maintenance functions* 
initiated by means o 
dependent DIAGNOSE in 
32-bit parameter is pro 
interruption to assist 
determining the operation 
interruption is reported. 



for a service 
the completion 
on-control and 
such as those 
f the model- 
struction. A 
vi ded wi th the 
the program in 
for which the 



Service signal is a floating inter- 
ruption condition and is presented to 
the first CPU in the configuration which 
can accept the interruption. The pend- 
ing request is cleared when it causes an 
interruption in any one of the CPUs and 
also by subsystem reset. 



The subclass-mask bit is in 
22 of control register 0. 
initialized to zero. 



bit position 
This bit is 



The service-signal condition is indi- 
cated by an external-interruption code 
of 2401 hex. A 32-bit parameter is 
stored at real locations 128-131. 



TOD-CLOCK SYNC CHECK 



The TOD-clock-sync-check condition indi- 
cates that more than one TOD clock 
exists in the configuration* and that 
the rightmost 32 bits of the clocks are 
not running in synchronism. 

An interruption request for a TOD-clock 
sync check exists when the TOD clock 
accessed by this CPU is running (that 
is, the clock is in the set or not-set 
state), the clock accessed by any other 
CPU in the configuration is running, and 
bits 32-63 of the two clocks do not 
match. When a clock is set or changes 
state, or when a running clock is added 
to the configuration, a delay of up to 
1.048576 seconds (2 20 microseconds) may 
occur before the mismatch condition is 
recogni zed. 

When only two TOD clocks are in the 
configuration and either or both of the 
clocks are in the error, stopped, or 
not-operational state, it is unpredict- 
able whether a TOD-clock-sync-check 
condition is recognized; if the condi- 
tion is recognized, it may continue to 
persist up to 1.048576 seconds after 
both clocks have been running with the 
rightmost 32 bits matching. However, in 
this case, the condition does not 
persist if one of the TOD clocks is 
removed from the configuration. 

When more than one CPU shares a TOD 
clock, only the CPU with the smallest 
CPU address among those sharing the 
clock indicates a TOD-clock-sync-check 
condition associated with that clock. 



If the con 
request i s r 
honored, th 
pending, an 
Conversely, 
by the inter 
tion pers 
i nterrupti on 
occurrence o 



dition responsible for the 
emoved before the request i s 
e request does not remain 
d no interruption occurs, 
the request is not cleared 
ruption, and, if the condi- 
ists, more than one 
may result from a single 
f the condition. 



The subclass-mask bit is in 
19 of control register 0. 
initialized to zero. 



bit position 
This bit is 



The TOD-clock-sync-check condition is 
indicated by an external-interruption 
code of 1003 hex. 



I/O INTERRUPTION 



The input/output (I/O) interruption 
provides a means by which the CPU 
responds to conditions originating in 
I/O devices and the channel subsystem. 
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A request for an I/O interruption may 
occur at any time, and more than one 
request may occur at the same time. The 
requests are preserved and remain pend- 
ing until accepted by a CPU, or until 
cleared by some other means, such as 
subsystem reset. 

The I/O interruption occurs at the 
completion of a unit of operation. 
Priority is established among requests 
so that in each CPU only one inter- 
ruption request is processed at a time. 
Priority among requests for inter- 
ruptions of differing I/O-interrupti on 
subclasses is according to the numerical 
value of the I/O-i nterrupti on subclass 
(with zero having the highest priority), 
in conjunction with the I/O-i nterrupti on 
subclass-mask settings in control regis- 
ter 6. For more details, see Chapter 
16, "I/O Interruptions." 

When a CPU becomes enabled for I/O 
interruptions and the channel subsystem 
has established priority for a pending 
I/O-interrupti on condition, the intei — 
ruption occurs at the completion of the 
instruction execution or interruption 
that causes the enabling. 



MACHINE-CHECK INTERRUPTION 



The machine-check interruption is a 
means for reporting to the program the 
occurrence of equipment malfunctions. 
Information is provided to assist the 
program in determining the source of the 
fault and extent of the damage. 

A machine-check interruption causes the 
old PSW to be stored at real location 48 
and a new PSW to be fetched from real 
location 112. 

The cause and severity of the malfunc- 
tion are identified by a 64-bit 
machine-check-interruption code stored 
at real locations 232-239. Further 
information identifying the cause of the 
interruption and the location of the 
fault may be stored at real locations 
216-511. 

The interruption action and the storing 
of the associated information are under 
the control of PSW bit 13 and bits in 
control register 14. See Chapter 11, 
"Machine-Check Handling," for more 
detailed information. 



An I/O 
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interruption causes the old PSW 
tored at real location 56 and a 

to be fetched from real location 
Additional information, in the 
an eight-byte I/O-i nterrupti on 
is stored at real locations 
The I/O-i nterrupti on code 
s of a 32-bit subsystem- 
i cation word and a 32-bit 
ption parameter. 



interruption can occur only while 
is enabled for the interruption 



subclass presenting the request. The 
I/O-mask bit, bit 6 of the PSW, and the 
I/O-interruption subclass mask in 
control register 6 determine whether the 
CPU is enabled for a particular I/O 
i nterrupti on. 

I/O interruptions are grouped into eight 
I/O-interruption subclasses, numbered 
from 0-7. Each I/O-interruption 
subclass has an associated I/O- 
interruption subclass-mask bit in bit 
positions 0-7 of control register 6. 
Each subchannel has an I/O-interruption 
subclass value associated with it. The 
CPU is enabled for I/O interruptions of 
a particular I/O-interruption subclass 
only when PSW bit 6 is one and the asso- 
ciated I/O-interruption subclass-mask 
bit in control register 6 is also one. 
If the corresponding I/O-interruption 
subclass-mask bit is zero, then the CPU 
is disabled for I/O interruptions with 
that subclass value. I/O interruptions 
for all subclasses sre disallowed when 
PSW bit 6 is zero. 



PROGRAM INTERRUPTION 



Program interruptions are used to report 
exceptions and events which occur during 
execution of the program. 

A program interruption causes the old 
PSW to be stored at real location 40 and 
a new PSW to be fetched from real 
location 104. 

The cause of the interruption is identi- 
fied by the interruption code. The 
interruption code is placed at real 
locations 142-143, 
length code i s placed 
and 6 of the byte at 
with the rest of the 
and zeros are stored 
140. For some causes, 



the instruction- 
in bit positions 5 
real location 141 
bits set to zeros, 
at real location 
additional infoi — 
mat ion identifying the reason for the 
interruption is stored at real locations 
144-159. 

Except for PER events, the condition 
causing the interruption is indicated by 
a coded value placed in the rightmost 
seven bit positions of the interruption 
code. Only one condition at a time can 
be indicated. Bits 0-7 of the intei — 
ruption code are set to zeros. 

PER events are indicated by setting bit 
8 of the interruption code to one. When 
this is the only condition, bits 0-7 and 
9-15 are also set to zeros. When a PER 
event is indicated concurrently with 
another program-interruption condition, 
bit 8 is one, and the coded value for 
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the other condition is 
positions 0~7 and 9-15. 



indicated in bit 



When there is a corresponding mask bit* 
a program interruption can occur only 
when that mask bit is one. The program 
mask in the PSW controls four of the 
exceptions* bit 1 in control register 
controls whether SET SYSTEM MASK causes 
a special-operation exception* bits 
16-31 in control register 8 control 
interruptions due to monitor events* and 
a hierarchy of masks control intei — 
ruptions due to PER events. When any 
controlling mask bit is zero* the condi- 
tion is ignored* the condition does not 
remain pending. 



Programmi ng Notes 
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Some of the conditions indicated as 
program exceptions may be recog- 
nized also by the channel subsys- 
tem, in which case the exception is 
indicated in the subchannel-status 
word or extended-status word. 



EXCEPTION-EXTENSION CODE 



When an arithmetic except io 
nized during execution of an 
ble vector instruction, 
exception-extension code is 
bits 0-7 of the program- 
code. This code is set t 
value only for arithmetic 
occurring during the executi 
instructions. For more deta 
publication IBM System/370 
ations, SA22-7125. 
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PROGRAM-INTERRUPTION CONDITIONS 



The following is a detailed description 
of each program-interruption condition. 



Addressi ng Except i on 



An addressing exception is recognized 
when the CPU attempts to reference a 
main-storage location that is not avail- 
able in the configuration. A main- 



storage location is not available in the 
configuration when the location is not 
installed, when the storage unit is not 
in the configuration, or when power is 
off in the storage unit. An address 
designating a storage location that is 
not available in the configuration is 
referred to as invalid. 

The operation is suppressed when the 
address of the instruction is invalid. 
Similarly, the operation is suppressed 
when the address of the target instruc- 
tion of EXECUTE is invalid. Also, the 
unit of operation is suppressed when an 
addressing exception is encountered in 
accessing a table entry. The table 
entries to which the rule applies are 
entries for the segment table, page 
table, linkage table, entry table* ASN 
first table* ASN second table* trace 
table* and authority table. Addressing 
exceptions result in suppression when 
they are encountered for references to 
the segment table and page table, in 
both implicit references for dynamic 
address translation and references asso- 
ciated with the execution of LOAD REAL 
ADDRESS and TEST PROTECTION. Except for 
some specific instructions whose 
execution is suppressed* the operation 
is terminated for an operand address 
that can be translated but designates an 
unavailable location. See the figure 
"Summary of Action for Addressing and 
Protection Exceptions." 

For termination* changes may occur only 
to result fields. In this context* the 
term "result field" includes the condi- 
tion code* registers* and any storage 
locations that are provided and that are 
designated to be changed by the instruc- 
tion. Therefore, if an instruction is 
due to change only the contents of a 
field in storage, and every byte of the 
field is in a location that is not 
available in the configuration, the 
operation is suppressed. When part of 
an operand location is available in the 
configuration and part is not, storing 
may be performed in the part that is 
available in the configuration. 

s, 
i/ 

When an addressing exception occurs 
during the fetching of an instruction or 
during the fetching of a DAT table entry 
associated with an instruction fetch, it 
is unpredictable whether the ILC is 1* 
2* or 3. When the exception is associ- 
ated with fetching the target of 
EXECUTE, the ILC is 2. 

In all cases of addressing exceptions 
not associated with instruction 
fetching* the ILC is 1* 2* or 3* indi- 
cating the length of the instruction 
that caused the reference. 

An addressing exception is indicated by 
a program-interruption code of 0005 hex 
(or 0085 hex if a concurrent PER event 
i s i ndi cated) . 
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Excepti on 



Action on 



Table- 
Entry Fetch 1 



Instruction 
Fetch 



Operand Reference 



Addressing 
excepti on 



Suppress 



Suppress 



Suppress for IPTE, LASP, 
LPSW, MSCH, SCKC, SPT, 
SPX, SSCH, SSM, STCRW, 
STNSM, STOSM, TPI, TPROT, 
and tracing 2 . 
Terminate for all others. 3 



Protecti on 
excepti on 
for key- 
controlled 
protecti on 



Suppress 



Suppress for IPTE, LASP, 
LPSW, MSCH, SCKC, SPT, 
SPX, SSCH, STNSM, STOSM, 
and TPI*. 
Terminate for all others. 3 



Protecti on 
excepti on 
for page 
protecti on 



Suppress for STCRW, 
STNSM, STOSM, and TPI 4 . 

Terminate for all others. 3 



Protecti on 
excepti on 
for low- 
address 
protecti on 



Suppress for STCRW, STNSM, 
STOSM, TPI 4 , and tracing 2 . 



Terminate for all others. 3 



Explanati on ? 



— Not applicable. 

1 Table entries include segment table, page table, linkage 
table, entry table, ASN first table, ASN second table, 
and authority table. 

2 The following instructions cause an entry to be made in 
the trace table when the corresponding tracing function 
is turned on: BALR, BASR, BASSM, PC, PT, SSAR, and 
TRACE. The stores into the trace table ara subject to 
addressing and low-address-protection exceptions. The 
operation is suppressed for these exceptions. 

3 For termination, changes may occur only to result 
fields. In this context, "result field" includes con- 
dition code, registers, and storage locations, if any, 
which ar& designated to be changed by the instruction. 
However, no change is made to storage location or a 
storage key when the reference causes an access excep- 
tion. Therefore, if an instruction is due to change 
only the contents of a fi*ld in main storage, and every 
byte of that field would cause an access exception, the 
operation is suppressed. 

4 When the effective address of TPI is zero, the store 
access is to implicit real locations 184-191, and key- 
controlled protection, page protection, and low-address 
protection do not apply. 



Summary of Action for Addressing and Protection Exceptions 
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AFX-Translati on Except i on 



An AFX-translati on exception is recog- 
nized when, during ASN translation in 
PROGRAM CALL with space switching 
(PC-ss), PROGRAM TRANSFER with space 
switching (PT-ss), or SET SECONDARY ASN 
with space switching (SSAR-ss), bit of 
the ASN-f i rst-table entry used is not 
zero. 

The ASN being translated is stored at 
real locations 146-147, and real 
locations 144-145 are set to zeros. 

The operation is nullified. 

The instruction-length code is 2. 

The AFX-translati on exception is indi- 
cated by a program-interruption code of 
0020 hex (or 00A0 hex if a concurrent 
PER event is indicated). 



ASN-Translat ion-Spec if i cat i on Exception 

An ASN-translati on-speci f i cati on excep- 
tion is recognized during ASN trans- 
lation in LOAD ADDRESS SPACE PARAMETERS, 
PROGRAM CALL with space switching 
(PC-ss), PROGRAM TRANSFER with space 
switching (PT-ss), or SET SECONDARY ASN 
with space switching (SSAR-ss) when 
either: 

1. Bit positions 28-31 of a valid 
ASN-f i rst-table entry do not 
contain zeros. 

2. Bit positions 30, 31, and 60-63 of 
a valid ASN-second-table entry do 
not contain zeros. 

The operation is suppressed. 

The instruction-length code is 2 or 3. 

The ASN-translati on-speci fi cati on excep- 
tion is indicated by a program- 
interruption code of 0017 hex (or 0097 
hex if a concurrent PER event is indi- 
cated) . 



ASX-Translati on Except i on 



An ASX-translati on exception is recog- 
nized when, during ASN translation in 
PROGRAM CALL with space switching 
(PC-ss), PROGRAM TRANSFER with space 
switching (PT-ss), or SET SECONDARY ASN 
with space switching (SSAR-ss), bit of 
the ASN-second-table entry used i s not 
zero. 



The ASN being translated is stored at 
real locations 146-147, and real 
locations 144-145 are set to zeros. 

The operation is nullified. 

The instruction-length code is 2. 

The ASX-translati on exception is indi- 
cated by a program-interruption code of 
0021 hex (or 00A1 hex if a concurrent 
PER event is indicated). 



Data Exception 



A data exception is recognized when any 
of the following is true: 

1. The sign or digit codes of operands 
in the decimal instructions 
(described in Chapter 8, "Decimal 
Instructions") or in CONVERT TO 
BINARY are invalid. 

2. The operand fields in ADD DECIMAL, 
COMPARE DECIMAL, DIVIDE DECIMAL, 
MULTIPLY DECIMAL, and SUBTRACT 
DECIMAL overlap in a way other than 
with coincident rightmost bytes; or 
operand fields in ZERO AND ADD 
overlap, and the rightmost byte of 
the second operand is to the right 
of the rightmost byte of the first 
operand. 

3. The multiplicand in MULTIPLY DECI- 
MAL has an insufficient number of 
leftmost zeros. 

The action taken for a data exception 
depends on whether a sign code is inval- 
id. The operation is suppressed when a 
sign code is invalid, regardless of 
whether any other condition causing the 
exception exists; when no sign code is 
invalid, the operation is terminated. 

For all instructions other than EDIT and 
EDIT AND MARK, when the operation is 
terminated, the contents of the sign 
position in the rightmost byte of the 
result field either remain unchanged or 
are set to the preferred sign code; the 
contents of the remainder of the result 
field are unpredictable. 

In the case of EDIT and EDIT AND MARK, 
an invalid sign code cannot occur; the 
operation is terminated on a data excep- 
tion for an invalid digit code. 

The instruction-length code is 2 or 3. 

The data exception is indicated by a 
program-interruption code of 0007 hex 
(or 0087 hex if a concurrent PER event 
is indicated). 
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Programmi ng Notes 



1. The definition for data exception 
permits termination when digit 
codes are invalid but no sign code 
is invalid. On some models, valid 
digit codes may be placed in the 
result field even if the original 
contents were invalid. Thus it is 
possible, after a data exception 
occurs, for all fields to contain 
valid codes. 

2. An invalid sign code for the right- 
most byte of the result field is 
not generated when the operation is 
terminated. However, an invalid 
second-operand sign code is not 
necessarily preserved when it is 
located in the numeric portion of 
the result field. 

3. When, after a program interruption 
for data exception, a sign code is 
found to be invalid, the operation 
has been suppressed if both of the 
following conditions are met : 

a. The invalid sign of the source 
field is not located in the 
numeric portion of the result 
field. 

b. The invalid sign code is in a 
position specified by the 
instruction to be checked for a 
valid sign. (This condition 
excludes the first operand of 
ZERO AND ADD, both operands of 
EDIT, and EDIT AND MARK.) 



Decimal-Pi vi de Excepti on 

A decimal-divide exception is recognized 

when in decimal division the divisor is 

zero or the quotient exceeds the speci- 
fied data-field size. 

The decimal-divide exception is indi- 
cated only if the sign codes of both the 
divisor and dividend are valid and only 
if the digit or digits used in estab- 
lishing the exception are valid. 

The operation is suppressed. 

The instruction-length code is 2 or 3. 

The decimal-divide exception is indi- 
cated by a program-interruption code of 
000B hex (or 008B hex if a concurrent 
PER event is indicated). 



Decimal -Over flow Excepti on 



A decimal-overflow exception is recog- 
nized when one or more nonzero digits 



are lost because the destination field 
in a decimal operation is too short to 
contain the result. 

The interruption may be disallowed by 
the decimal-overflow mask (PSW bit 21). 

The operation is completed. The result 
is obtained by ignoring the overflow 
digits, and condition code 3 is set. 

The instruction-length code is 2 or 3. 

The decimal-overflow exception is indi- 
cated by a program-interruption code of 
000A hex (or 008A hex if a concurrent 
PER event is indicated). 



Execute Excepti on 

The execute exception is recognized when 
the target instruction of EXECUTE is 
another EXECUTE. 

The operation is suppressed. 

The instruction-length code is 2. 

The execute exception is indicated by a 
program-interruption code of 0003 hex 
(or 0083 hex if a concurrent PER event 
is indicated). 



Exponent-Overflow Excepti on 



An exponent-overflow exception is recog- 
nized when the result characteristic of 
a floating-point operation exceeds 127 
and the result fraction is not zero. 

The operation is completed. The frac- 
tion is normalized, and the sign and 
fraction of the result remain correct. 
The result characteristic is made 128 
smaller than the correct characteristic. 

The instruction-length code is 1 or 2. 

The exponent-overflow exception is indi- 
cated by a program-interruption code of 
XX0C hex (or XX8C hex if a concurrent 
PER event is indicated), where XX is the 
exception-extension code. 



Exponent-Underflow Exception 



An exponent-underflow exception is re- 
cognized when the result characteristic 
of a floating-point operation is less 
than zero and the result fraction is not 
zero. For an extended-format floating- 
point result, exponent underflow is 
indicated only when the high-order char- 
acteristic underflows. 
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The interruption may be disallowed by 
the exponent-underflow mask (PSW bit 
22). 
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The instruction-length code is 1 or 2. 

The exponent-underflow exception is in- 
dicated by a program-interruption code 
of XXOD hex (or XX8D hex if a concurrent 
PER event is indicated), where XX is the 
exception-extension code. 



EX-Translation Exception 



An EX-translati on exception is recog- 
nized during PC-number translation in 
PROGRAM CALL when the entry-table entry 
indicated by the entry-table-index part 
of the PC number is beyond the length of 
the entry table as designated by the 
linkage-table entry. 

The PC number is stored in bit positions 
12-31 of the word at real location 144, 
and the leftmost 12 bits of the word are 
set to zeros. 

The operation is nullified. 

The instruction-length code is 2. 

The EX-translati on exception is indi- 
cated by a program-interruption code of 
0023 hex (or 00A3 hex if a concurrent 
PER event is indicated). 



Fixed-Point-Di vi de Excepti on 



A fixed-point-divide exception is recog- 
nized when in signed binary division the 
divisor is zero or when the quotient in 
signed binary division or the result of 
CONVERT TO BINARY cannot be expressed as 
a 32-bit signed binary integer. 

In the case of division, the operation 
is suppressed. The execution of CONVERT 
TO BINARY is completed by ignoring the 
leftmost bits that cannot be placed in 
the register. 

The instruction-length code is 1 or 2. 

The fixed-point-divide exception is in- 
dicated by a program-interruption code 
of 0009 hex (or 0089 hex if a concurrent 
PER event is indicated). 



Fixed-Point-Overflow Exception 



A fixed-point-overflow exception is re- 
cognized when an overflow occurs during 
signed binary arithmetic or signed 
left-shift operations. 

The interruption may be disallowed by 
the fixed-point-overflow mask (PSW bit 
20). 



The operation 
is obtained 
i nformati on, 
set. 



is completed. The result 
by ignoring the overflow 
and condition code 3 is 



The instruction-length code is 1 or 2. 

The fixed-point-overflow exception is 
indicated by a program-interruption code 
of XX08 hex (or XX88 hex if a concurrent 
PER event is indicated), where XX is the 
exception-extension code. 



Floating-Point-Pi vi de Exception 

A floating-point-divide exception is 
recognized when in floating-point divi- 
sion the divisor has a zero fraction. 

The operation is suppressed. 

The instruction-length code is 1 or 2. 

The floating-point-divide exception is 
indicated by a program-interruption code 
of XX0F hex (or XX8F hex if a concurrent 
PER event is indicated), where XX i s the 
exception-extension code. 



LX-Translation Exception 



An LX-translati on exception is recog- 
nized during PC-number translation in 
PROGRAM CALL when either: 

1. The linkage-table entry indicated 
by the linkage-table-index part of 
the PC number is beyond the length 
of the linkage table as designated 
by control register 5. 

2. Bit of the linkage-table entry is 
not zero. 

The PC number is stored in bit positions 
12-31 of the word at real location 144, 
and the leftmost 12 bits of the word are 
set to zeros. 

The operation is nullified. 

The instruction-length code is 2. 
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The LX-translati on exception is indi- 
cated by a program-interruption code of 
0022 hex (or 00A2 hex if a concurrent 
PER event is indicated). 



Monitor Event 



A monitor event is recognized when MONI- 
TOR CALL is executed and the monitoi — 
mask bit in control register 8 
corresponding to the class specified by 
instruction bits 12-15 is one. The 
information in control register 8 has 
the following format: 



Control Regi ster 8 



Monitor Masks 



16 



31 



The monitor-mask bits* bits 16-31 of 
control register 8* correspond to moni- 
tor classes 0-15* respectively. Any 
number of monitoi — mask bits may be on at 
a time; together they specify the class- 
es of monitor events that are monitored 
at that time. The mask bits are 
initialized to zeros. 

When MONITOR CALL is executed and the 
corresponding monitor-mask bit is one, a 
program interruption for monitor event 
occurs. 

Additional information is stored at real 
locations 148-149 and 156-159. The 
format of the information stored at 
these locations is as follows: 

Real Locations 148-149 



00000000 



Moni tor 
Class No 



15 



Real Locations 156-159 



Monitor Code 



1 31 

The contents of bit positions 8-15 of 
the MONITOR CALL instruction are stored 
at real location 149 and constitute the 
monitoi — class number. Zeros are stored 
at real location 148. The effective 
address specified by the B t and D t 
fields of the instruction forms the 
monitor code* which is stored in the 
word at real location 156. The value of 
the address is under control of the 
addressing mode* bit 32 of the current 
PSW; in the 24-bit addressing mode* bits 
0-7 of the address &re zeros* while in 



the 31-bit addressing mode* bit is 
zero. 

The operation is completed. 

The instruction-length code is 2. 

The monitor event is indicated by a 
program-interruption code of 0040 hex 
(or 00C0 hex if a concurrent PER event 
i s i ndi cated) . 



Operand Exception 



An operand exception is recognized when 
any of the following is true: 

1. Execution of CLEAR SUBCHANNEL, HALT 
SUBCHANNEL, MODIFY SUBCHANNEL, 
RESUME SUBCHANNEL, START SUBCHAN- 
NEL, STORE SUBCHANNEL, or TEST 
SUBCHANNEL is attempted, and bits 
0-15 of general register 1 do not 
contain 0001 hex. 

2. Execution of MODIFY SUBCHANNEL is 
attempted, and bits 0-1 and 5-7 of 
word 1 and bits 0-31 of word 6 of 
the SCHIB operand are not all 
zeros. 

3. Execution of MODIFY SUBCHANNEL is 
attempted* and bits 9 and 10 of 
word 1 of the SCHIB operand are 
both ones. 

4. Execution of RESET CHANNEL PATH is 
attempted* and bits 0-23 of general 
register 1 are not all zeros. 

5. Execution of SET ADDRESS LIMIT is 
attempted* and bits and 16-31 of 
general register 1 are not all 
zeros. 

6. Execution of SET CHANNEL MONITOR is 
attempted* bit 30 of general regis- 
ter 1 is one* and bits and 27-31 
of general register 2 &re not all 
zeros. 

7. Execution of SET CHANNEL MONITOR is 
attempted, and bits 4-29 of general 
register 1 are not all zeros. 

8. On some models* execution of START 
SUBCHANNEL is attempted, and bits 
5-7, 13-15* and 25-31 of word 1 and 
bit of word 2 of the ORB operand 
are not all zeros. 

9. On some models* execution of START 
SUBCHANNEL is attempted* the incor- 
rect-length-i ndi cat i on suppressi on 
facility is not installed* and bit 
24 of word 1 of the ORB is one. 

The operation is suppressed. 

The instruction-length code is 2. 
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The operand exception is indicated by a 
program-interruption code of 0015 hex 
(or 0095 hex if a concurrent PER event 
is indicated). 



Qperati on Except i on 



An operation exception is recognized 
when the CPU attempts to execute an 
instruction with an invalid operation 
code. The operation code may be unas- 
signed, or the instruction with that 
operation code may not be installed on 
the CPU. 

For the purpose of checking the opera- 
tion code of an instruction* the opera- 
tion code is defined as follows: 

1. When the first eight bits of an 
instruction have the value 01, B2, 
A4, A5, A6, E4, or E5 hex, the 
first 16 bits form the operation 
code. 

2. In all other cases, the first eight 
bits alone form the operation code. 



Page-Translat i on Except i on 



The operation is suppressed. 

The instruction-length code is 
3. 



1, 2, or 



The operation exception is indicated by 
a program-interruption code of 0001 hex 
(or 0081 hex if a concurrent PER event 
i s i ndi cated) . 



A page-translation 
nized when either: 



exception is recog- 



1. The page-table entry indicated by 
the page-index portion of a virtual 
address is outside the page table. 

2. The page-invalid bit is one. 

The exception is recognized as part of 
the execution of the instruction that 
needs the page-table entry in the trans- 
lation of either an instruction or opei — 
and address, except for the operand 
address in LOAD REAL ADDRESS and TEST 
PROTECTION, in which case the condition 
is indicated by the setting of the 
condition code. 

The segment-index and page-index portion 
of the virtual address causing the 
exception is stored at real locations 
144-147. Bit of real location 144 is 
set to zero if the virtual address was 
relative to the primary address space, 
or it is set to one if the virtual 
address was relative to the secondary 
address space. The rightmost 12 bits of 
the address stored are unpredictable. 

The unit of operation is nullified. 

When the exception occurs during fetch- 
ing of an instruction, it is unpredict- 
able whether the ILC is 1, 2, or 3. 
When the exception occurs during a 
reference to the target of EXECUTE, the 
ILC is 2. 



Programmi ng Notes 



Some models may offer instructions 
not described in this publication, 
such as those provided for assists 
or as part of special or custom 
features. Consequently, operation 
described in this publi- 
not necessarily cause an 
exception to be recog- 
Furthermore, these 
may cause modes of 
be set up or may 



2. 



> 



codes not 
cation do 
operati on 
ni zed. 

i nstructi ons 
operation to 
otherwise alter the machine so as 
to affect the execution of subse- 
quent instructions. To avoid 
causing such an operation, an 
instruction with an operation code 
not described in this publication 
should be executed only when the 
specific function associated with 
the operation code is desired. 

The operation code 00, with a two- 
byte instruction format, currently 
is not assigned. It is improbable 
that this operation code will ever 
be assigned. 



When the exception occurs during a 
reference to an operand location, the 
instruction-length code (ILC) is 1, 2, 
or 3 and indicates the length of the 
instruction causing the exception. 

The page-translation exception is indi- 
cated by a program-interruption code of 
0011 hex (or 0091 hex if a concurrent 
PER event is indicated). 



PC-Translat i on- Spec i f i cati on Excepti on 

A PC-translation-specification exception 
is recognized during PC-number trans- 
lation in PROGRAM CALL when bit position 
32 of the entry-table entry is zero and 
bit positions 33-39 are not all zeros. 

The operation is suppressed. 

The instruction-length code is 2. 

The PC-translation-specification excep- 
tion is indicated by a program- 
interruption code of 001F hex (or 009F 
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hex if a concurrent PER event 
cated) . 



is indi- 



0024 hex (or 00A4 hex if 
PER event is indicated). 



a concurrent 



PER Event 



Pri vi leged-Qperati on Exception 



A PER event is recognized when the CPU 
is enabled for PER and one or more of 
these events occur. 

The PER mask, bit 1 of the PSW, controls 
whether the CPU is enabled for PER. 
When the PER mask is zero* PER events 
are not recognized. Nhen the bit is 
one, PER events are recognized, subject 
to the PER-event-mask bits in control 
register 9. 

The unit of operation is completed, 
unless another condition has caused the 
unit of operation to be inhibited, 
nullified, suppressed, or terminated. 



Addi tional 
event i s 
150-155. 



information identifying the 
stored at real locations 



The instruction-length code is 0, 1, 2, 

or 3. Code is set only if a specifi- 
cation exception is indicated concui — 
rently. 

The PER event is indicated by setting 
bit 8 of the program-interruption code 
to one. 

See the section "Program-Event Record- 
ing" in Chapter 4, "Control," for a de- 
tailed description of the PER event and 
the associated interruption information. 



Primary-Authori tv Except i on 



A primary-authority exception is recog- 
nized during ASN authorization in 
PROGRAM TRANSFER with space switching 
(PT-ss) when either: 

1. The authority-table entry indicated 
by the authorization index in 
control register 4 is beyond the 
length of the authority table 
designated by the ASN-second-table 
entry. 

2. The primary-authority bit indicated 
by the authorization index is zero. 

The ASN being translated is stored at 
real locations 146-147, and real 
locations 144-145 are set to zeros. 

The operation is nullified. 

The instruction-length code is 2. 

The primary-authority exception is indi- 
cated by a program-interruption code of 



A privileged-operation exception is 
recognized when any of the following is 
true? 

1. Execution of a privileged instruc- 
tion is attempted in the problem 
state. 

2. The value of the rightmost bit of 
the general register designated by 
the R 2 field of the PROGRAM TRANS- 
FER instruction is zero and would 
cause the PSW problem-state bit to 
change from the problem state (one) 
to the supervisor state (zero). 

3. In the problem state, the key value 
specified by the second operand of 
the SET PSW KEY FROM ADDRESS 
instruction corresponds to a zero 
PSW-key-mask bit in control regis- 
ter 3. 

4. In the problem state, the key value 
specified by the rightmost byte of 
the register designated by the R 3 
field of the MOVE WITH KEY instruc- 
tion corresponds to a zero PSW- 
key-mask bit in control register 3. 

5. In the problem state, the key value 
specified by the rightmost byte of 
the register designated by the R 3 
field of the instructions MOVE TO 
PRIMARY and MOVE TO SECONDARY 
corresponds to a zero PSW-key-mask 
bit in control register 3. 

6. In the problem state, any of the 
instructions 

EXTRACT PRIMARY ASN 
EXTRACT SECONDARY ASN 
INSERT ADDRESS SPACE CONTROL 
INSERT PSW KEY 
INSERT VIRTUAL STORAGE KEY 

is encountered, and the 
extraction-authority control, bit 4 
of control register 0, is zero. 

7. In the problem state, the result of 
ANDing the authorization key mask 
(AKM) with the PSW-key mask in 
control register 3 during PROGRAM 
CALL produces a result of zero. 

The operation is suppressed. 

The instruction-length code is 2 or 3. 

The privileged-operation exception is 
indicated by a program-interruption code 
of 0002 hex (or 0082 hex if a concurrent 
PER event is indicated). 
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Protect! on Excepti on 



A protection exception is recognized 
when any of the following is true: 

1. Key-Controlled Protection : The CPU 
attempts to access a storage 
location that is protected against 
the type of reference* and the 
access key does not match the stor- 
age key. 

2. low-Address Protection : The CPU 
attempts a store that is subject to 
low-address protection* the effec- 
tive address is in the range 0-511* 
and the low-address protection 
control, bit 3 of control register 
0* is one. 

3. Page Protecti on : The CPU attempts 
to store* with DAT on* into a page 
which has the page-protection bit 
set to one. 

The operation is suppressed when the 
location of the instruction is protected 
against fetching. Similarly* the opera- 
tion is suppressed when the location of 
the target instruction of EXECUTE is 
protected against fetching. 

Except for some specific instructions 
whose execution is suppressed, the opei — 
ation is terminated when a protection 
exception is encountered during a refei — 
ence to an operand location. See the 
figure "Summary of Action for Protection 
and Addressing Exceptions*" which is 
included in the section "Addressing 
Exception" in this chapter. 

For termination* changes may occur only 
to result fields. In this context* the 
term "result field" includes condition 
code* registers* and storage locations* 
if any* which are due to be changed by 
the instruction. However* no change is 
made to a storage location when a refei — 
ence to that location causes a 
protection exception. Therefore* if an 
instruction is due to change only the 
contents of a field in storage, and 
every byte of that field would cause a 
protection exception, the operation is 
suppressed. When termination occurs on 
fetching, the protected information is 
not loaded into an addressable register 
nor moved to another storage location. 

When the exception occurs during fetch- 
ing of an instruction, it is unpredict- 
able whether the ILC is 1* 2, or 3. 
When the exception occurs during the 
fetching of the target of EXECUTE, the 
ILC is 2. 

For a protected operand location, the 
instruction-length code (ILC) is 1, 2, 
or 3, indicating the length of the 
instruction that caused the reference. 



The protection exception is indicated by 
a program-interruption code of 0004 hex 
(or 0084 hex if a concurrent PER event 
is indicated). 



Secondary-Authori tv Exception 



A secondary-authority exception is 
recognized during ASN authorization in 
SET SECONDARY ASN with space switching 
(SSAR-ss) when either: 

1. The authority-table entry indicated 
by the authorization index in 
control register 4 is beyond the 
length of the authority table 
designated by the ASN-second-table 
entry. 

2. The secondary-authority bit indi- 
cated by the authorization index is 
zero. 

The ASN being translated is stored at 
real locations 146-147, and real 
locations 144-145 are set to zeros. 

The operation is nullified. 

The instruction-length code is 2. 

The secondary-authority exception is 
indicated by a program-interruption code 
of 0025 hex (or 00A5 hex if a concurrent 
PER event is indicated). 



Segment-Translati on Excepti on 



A segment-translation 
recognized when either: 



exception is 



1. The segment-table entry indicated 
by the segment-index portion of a 
virtual address is outside the 
segment table. 

2. The segment- i nvali d bit is one. 



The exception is 
the execution of 
needs the segme 
translation of ei 
operand address, 
address in LOAD 
PROTECTION, in wh 
is indicated by 
condition code. 



recognized as 
the instructi 
nt-table entry 
ther the instru 
except for the 
REAL ADDRESS a 
i ch case the c 
the setting 



part of 
on that 

in the 
ction or 

operand 
nd TEST 
ondi tion 

of the 



The segment-index and page-index portion 
of the virtual address causing the 
exception is stored at real locations 
144-147. Bit of real location 144 is 
set to zero if the virtual address was 
relative to the primary address space, 
or it is set to one if the virtual 
address was relative to the secondary 
address space. The rightmost 12 bits of 
the address stored are unpredictable. 
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The unit of operation is nullified. 

When the exception occurs during fetch- 
ing of an instruction* it is unpredict- 
able whether the ILC is 1* 2* or 3. 
When the exception occurs during the 
fetching of the target of EXECUTE, the 
ILC is 2. 

When the exception occurs during a 
reference to an operand location* the 
instruction-length code (ILC) is 1* 2* 
or 3 and indicates the length of the 
instruction causing the exception. 

The segment-translation exception is 
indicated by a program-interruption code 
of 0010 hex (or 0090 hex if a concurrent 
PER event is indicated). 



Si gni f icance Except i on 



A significance exception is recognized 
when the result fraction in floating- 
point addition or subtraction is zero. 

The interruption may be disallowed by 
the significance mask (PSW bit 23). 

The operation is completed. The signif- 
icance mask also affects the result of 



the operation. When 
zero* the operation 
replacing the result 
When the mask bit is 
is completed without 
the characteristic of 



the mask bit is 
is completed by 

with a true zero. 

one* the operation 

further change to 

the result. 



The instruction-length code is 1 or 2. 

The significance exception is indicated 
by a program-interruption code of XX0E 
hex (or XX8E hex if a concurrent PER 
event is indicated)* where XX is the 
exception-extension code. 



Space-Swi tch Event 



A space-switch event is recognized at 
the completion of a PROGRAM CALL with 
space switching (PC-ss) or a PROGRAM 
TRANSFER with space switching (PT-ss) 
when any of the following is true: 

1. The space-switch-event-control bit* 
bit of control register 1* is one 
before the operation. 

2. The space-switch-event-control bit 
is one after the operation. 

3. A PER event is reported. 

The old PASN* which is in the right half 
of control register 4 before the 
execution of the instruction PC-ss or 
PT-ss* is stored at real locations 
146-147. The old space-switch-event- 



control bit is placed in bit position 
and zeros are placed in bit positions 
1-15 at real locations 144-145. 

The operation is completed. 

The instruction-length code is 2. 

The space-switch event is indicated by a 
program-interruption code of 001C hex 
(or 009C hex if a concurrent PER event 
i s i ndi cated) . 



Programming Notes 



1. The space-sw 
control pro 
whenever a p 
a parti cula 
space-swi tch 
loaded into 
along with 
the primary 
nation, when 
is loaded. 



itch event 
gram to 
rogram ent 
r address 
-event-con 

control 
the remai 

segment- 
ever contr 



permits the 
gain control 
ers or leaves 

space. The 
trol bit is 

register 1, 
ning bits of 
table desig- 
ol register 1 



The space-switch event may be 
useful in obtaining programmed 
authorization checking* in causing 
additional trace information to be 
recorded* or in enabling or disabl- 
ing the CPU for PER or tracing. 



Bit 64 of the ASN- 
entry (ASTE) is loade 
position of control r 
part of the PC-ss and 
ations. If bit 64 of 
a particular address s 
to one, then a space- 
is recognized when a pr 
or leaves the addres 
means of either a PC-ss 



second-table 
d into bit 
egister 1 as 

PT-ss opei — 
the ASTE for 
pace i s set 
switch event 
ogram enters 
s space by 

or a PT-ss. 



The occurrence of a space-switch 
event at the completion of a PC-ss 
or PT-ss when any PER event is 
indicated permits the control 
program to determine the address 
space from which the instruction 
causing the PER event was fetched. 



Special-Operation Exception 



A special-operation exception is recog- 
nized when any of the following is true? 

1. Execution of SET SYSTEM MASK is 
attempted in the supervisor state 
and the SSM-suppressi on control* 
bit 1 of control register 0* is 
one. 

2. Execution of any of the following 
instructions is attempted with DAT 
off: 



EXTRACT PRIMARY ASN 
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EXTRACT SECONDARY ASN 

INSERT ADDRESS SPACE CONTROL 

INSERT VIRTUAL STORAGE KEY 

MOVE TO PRIMARY 

MOVE TO SECONDARY 

SET ADDRESS SPACE CONTROL 

SET SECONDARY ASN 

3. Execution of PROGRAM CALL or 
PROGRAM TRANSFER is attempted, and 
the CPU is not in the primary-space 
mode. 

4. Execution of LOAD ADDRESS SPACE 
PARAMETERS, PROGRAM CALL with space 
switching (PC-ss), PROGRAM TRANSFER 
with space switching (PT-ss), or 
SET SECONDARY ASN (SSAR-cp or 
SSAR-ss) is attempted, and the 
ASN-translation control, bit 12 of 
control register 14, is zero. 

5. Execution of PROGRAM CALL or 
PROGRAM TRANSFER is attempted and, 
the subsystem-linkage control, bit 
of control register 5, is zero. 

6. Execution of SET ADDRESS SPACE 
CONTROL, MOVE TO PRIMARY, or MOVE 
TO SECONDARY is attempted, and the 
secondary-space control, bit 5 of 
control register 0, is zero. 

The operation is suppressed. 

The instruction-length code is 1, 2, or 
3, and indicates the length of the 
instruction causing the exception. 

The special-operation exception is indi- 
cated by a program-interruption code of 
0013 hex (or 0093 hex if a concurrent 
PER event is indicated). 



Speci f i cati on Except i on 



A specification exception is recognized 
when any of the following is true: 

1. A one is introduced into an unas- 
signed bit position of the PSW 
(that is, any of bit positions 0, 
2-4, 17, or 24-31). This is 
handled as an early PSW specifica- 
tion exception. 

2. A zero is introduced into bit posi- 
tion 12 of the PSW. This is 
handled as an early PSW specifica- 
tion exception. 

3. A zero is introduced into bit posi- 
tion 32 of the PSW, but bits 33-39 
are not all zeros. This is handled 
as an early PSW specification 
exception. 



The PSW contains an 
address. 



odd instruction 



5. An operand address does not desig- 
nate an integral boundary in an 
instruction requiring such 
integral-boundary designation. 

6. An odd-numbered general register is 
designated by an R field of an 
instruction that requires an even- 
numbered register designation. 

7. A floating-point register other 
than 0, 2, 4, or 6 is designated 
for a short or long operand, or a 
floating-point register other than 
or 4 is designated for an 
extended operand. 

8. The multiplier or divisor in deci- 
mal arithmetic exceeds 15 digits 
and sign. 

9. The length of the first-operand 
field is less than or equal to the 
length of the second-operand field 
in decimal multiplication or divi- 
sion. 

10. Bit positions 8-11 of MONITOR CALL 
do not contain zeros. 

11. Bits 20-22 of the second-operand 
address of SET ADDRESS SPACE 
CONTROL are not all zeros. 

12. The addressing bit in the general 
register designated by the R 2 field 
of PROGRAM TRANSFER is zero, but 
the leftmost seven bits of the 
instruction address in the same 
register are not all zeros. 

13. Execution of COMPARE AND FORM CODE- 
WORD is attempted, and general 
registers 1, 2, and 3 do not 
initially contain even values. 

14. Execution of UPDATE TREE is 
attempted, and bits 29-31 of gener- 
al registers 4 and 5 do not 
initially contain zeros. 

The execution of the instruction identi- 
fied by the old PSW is suppressed. 
However, for early PSW specification 
exceptions (causes 1-3), the operation 
that introduces the new PSW is 
completed, but an interruption occurs 
immediately thereafter. 

Except as noted below, the instruction- 
length code (ILC) is 1, 2, or 3, indi- 
cating the length of the instruction 
causing the exception. 

When the instruction address is odd 
(cause 4), it is unpredictable whether 
the ILC is 1, 2, or 3. 

When the exception is recognized because 
of an early PSW specification exception, 
(causes 1-3), and the exception has been 
introduced by LOAD PSW or an inter- 
ruption, the ILC is 0. When the excep- 
tion is introduced by SET SYSTEM MASK or 
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by STORE THEN OR SYSTEM MASK, the ILC is 
2. 

The specification exception is indicated 
by a program-interruption code of 0006 
hex (or 0086 hex if a concurrent PER 
event is indicated). 



Programming Note 



See the section "Exceptions Associated 
with the PSW" in this chapter for a 
definition of when the exceptions asso- 
ciated with the PSW are recognized. 



Trace-Table Exception 



A trace-table exception is recognized 
when the CPU attempts to store a trace- 
table entry which would reach or cross 
the next 4K-byte block boundary. For 
the purpose of recognizing this excep- 
tion in the TRACE instruction, the 
explicit trace entry is treated as being 
76 bytes long. 



The operation is nullified. 

The instruction-length code 
3, indicating the length of 
tion causing the exception. 



i s 
the 



1, 2, or 
i nstruc- 



The trace-table exception is indicated 
by a program-interruption code of 0016 
hex (or 0096 hex if a concurrent PER 
event is indicated). 



Translation-Speci f i cati on Except i on 



A translation-specification exception is 
recognized when translation of a virtual 
address i s attempted and any of the 
following is true: 

1. Bit positions 8-12 of control 
register do not contain the code 
10110. 

2. The segment-table entry used for 
the translation is valid, and bit 
position in the entry does not 
contain zero. 

3. The page-table entry used for the 
translation is valid, and bit posi- 
tions 0, 20, and 23 in the entry do 
not contain zeros. 

The exception is recognized only as part 
of the execution of an instruction using 
address translation, that is, when DAT 
is on and a logical address, instruction 
address, or virtual address must be 



translated, or when LOAD REAL ADDRESS or 
INVALIDATE PAGE TABLE ENTRY is executed. 
Cause 1 is recognized on any translation 
attempt; causes 2 and 3 are recognized 
only for table entries that are actually 
used. 

The unit of operation is suppressed. 

When the exception occurs during fetch- 
ing of an instruction, it is unpredict- 
able whether the ILC is 1, 2, or 3. 
When the exception occurs during the 
fetching of the target of EXECUTE, the 
ILC is 2. 

When the exception occurs during a 
reference to an operand location, the 
instruction-length code (ILC) is 1, 2, 
or 3 and indicates the length of the 
instruction causing the exception. 

The translation-specification exception 
is indicated by a program-interruption 
code of 0012 hex (or 0092 hex if a 
concurrent PER event is indicated). 



Programming Note 

When a translation-specification excep- 
tion is recognized in the process of 
translating an instruction address, the 
operation is suppressed. In this case, 
the instruction-length code (ILC) is 
needed to derive the address of the 
instruction, as the instruction address 
in the old PSW has been incremented by 
the amount indicated by the ILC. In the 
case of segment-translation and page- 
translation exceptions, the operation is 

the instruction address in 
identifies the instruction, 

may be arbitrarily set to 1, 



nulli f ied, 
the old PSW 
and the ILC 
2, or 3. 



Unnormal i zed-Operand Except i on 



An unnormal i zed-operand exception is 
recognized when, in a vector floating- 
point divide or multiply operation, a 
source-operand element has a nonzero 
fraction with a leftmost hexadecimal 
digit of zero. For more details, see 
the publication IBM Svstem/370 Vector 
Operations , SA22-7125. 

The unit of operation is inhibited. 

The instruction-length code is 2. 

The unnormal i zed-operand exception is 
indicated by a program-interruption code 
of XX1E hex (or XX9E hex if a concurrent 
PER event is indicated), where XX is the 
exception-extension code. 
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Vector-Qperati on Except i on 



A vector-operation exception is recog- 
nized when a vector-facility instruction 
is executed while bit 14 of control 
register is zero on a CPU which has 
the vector facility installed and avail- 
able. The vector-operation exception is 
also recognized when a vectoi — facility 
instruction is executed and the vector 
facility is not installed or available 
on this CPU, but the facility can be 
made available to the program either on 
this CPU or another CPU in the config- 
urati on . 

When a vectoi — facility instruction is 
executed, and the vector facility is not 
installed on any CPU which is or can be 
placed in the configuration, it depends 
on the model whether a vectoi — operation 
exception or an operation exception is 
recogni zed. 



The operation is 
vectoi — operati on 
recognized. 



nullified when the 
exception is 



The instruction-length code is 2 or 3. 

The vector-operation exception is indi- 
cated by a program-interruption code of 
0019 hex Cor 0099 hex if a concurrent 
PER event is indicated). 



An access exception is not recognized 
when the CPU attempts to prefetch from 
an unavailable location or detects some 
other access-exception condition, but a 
branch instruction or an interruption 
changes the instruction sequence such 
that the instruction is not executed. 

Every instruction can cause an access 
exception to be recognized because of 
instruction fetch. Additionally, access 
exceptions associated with instruction 
execution may occur because of an access 
to an operand in storage. 

An access exception due to fetching an 
instruction is indicated when the first 
instruction halfword cannot be fetched 
without encountering the exception. 
When the first halfword of the instruc- 
tion has no access exceptions, access 
exceptions may be indicated for addi- 
tional halfwords according to the 
instruction length specified by the 
first two bits of the instruction; 
however, when the operation can be 
performed without accessing the second 
or third halfwords of the instruction, 
it is unpredictable whether the access 
exception is indicated for the unused 
part. Since the indication of access 
exceptions for instruction fetch is 
common to all instructions, it is not 
covered in the individual instruction 
def ini ti ons. 



COLLECTIVE PROGRAM-INTERRUPTION NAMES 



For the sake of convenience, certain 
program exceptions are grouped together 
under a single collective name. These 
collective names are used when it is 
necessary to refer to the complete set 
of exceptions, such as in instruction 
definitions. Three collective names are 
used: 

Access exceptions 
ASN-translati on exceptions 
Trace exceptions 

The individual exceptions and their 
priorities are listed in the section 
"Multi pie-Program- Interrupt ion Condi - 
tions" in this chapter. 



RECOGNITION OF ACCESS EXCEPTIONS 



The figure "Handling of Access 
Exceptions" summarizes the conditions 
that can cause access exceptions and the 
action taken when they are encountered. 

Any access exception is recognized as 
part of the execution of the instruction 
with which the exception is associated. 



Except where otherwise indicated in the 
individual instruction description, the 
following rules apply for exceptions 
associated with an access to an operand 
location. For a fetch-type operand, 
access exceptions are necessarily indi- 
cated only for that portion of the 
operand which is required for completing 
the operation. It is unpredictable 
whether access exceptions are indicated 
for those portions of a fetch-type opei — 
and which are not required for 
completing the operation. For a store- 
type operand, access exceptions are 
recognized for the entire operand even 
if the operation could be completed 
without the use of the inaccessible part 
of the operand. In situations where the 
value of a store-type operand is defined 
to be unpredictable, it is unpredictable 
whether an access exception is 
i ndi cated. 
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Condition 



Translation for 
Virtual Address 
of LRA 



Indi- 
cation 



Action 



Translation 
and Access for 
Logical Address 
of TPROT 



Indi- 
cation 



Action 



Translation and 
Access for Any 
Other Address 



Indi- 
cati on 



Action 



Control-regi stei — contents 1 
Invalid encoding of bits 8-12 

Segment-table entry 
Segment-table-length violation 
Entry protected against fetching 
Invalid address of entry 
I bit on 

One in a bit position which is 
checked for zero 3 

Page-table entry 
Page-table-length violation 
Entry protected against fetching 
Invalid address of entry 
I bit on 

One in a bit position which is 
checked for zero 3 

Access for i nstructi on fetch 
Location protected 
Invalid address 

Access for operands 
Location protected 
Invalid address 



TS 



cc3 

A 

ccl 

TS 



cc3 

A 
cc2 

TS 



Suppress 



Complete 

Suppress 
Complete 
Suppress 



Complete 

Suppress 
Complete 
Suppress 



_2 



cc3 

A 

cc3 

TS 



cc3 

A 

cc3 

TS 



_2 



Complete 

Suppress 
Complete 
Suppress 



Complete 

Suppress 
Complete 
Suppress 



cc set 4 
A 



Complete 
Suppress 



TS 



ST 

A 
ST 
TS 



PT 

A 
PT 
TS 



Suppress 



Nullify 

Suppress 

Nullify 

Suppress 



Nullify 

Suppress 

Nullify 

Suppress 



Suppress 
Suppress 



Term.* 
Term.* 



Explanati on? 



A 

ccl 

cc2 

cc3 

P 

PT 

ST 

TS 



The condition does not apply. 

Action is to terminate except where otherwise specified in this publication. 
A translation-specification exception for an invalid code in control reg- 
ister 0, bit positions 8-12* is recognized as part of the execution of the 
instruction using address translation; when DAT is on, it is recognized 
during translation of the instruction address, and, when DAT is off, it is 
only recognized during execution of INVALIDATE PAGE TABLE ENTRY or for 
translation of the operand address of LOAD REAL ADDRESS. 

A translation-specification exception cannot occur for the logical address 
of TEST PROTECTION because this exception would have been recognized during 
the instruction fetch for the instruction. 

A translation-specification exception for a format error in a table entry 
is recognized only when the execution of an instruction requires the entry 
for translation of an address. 
The condition code is set as follows: 

Operand location not protected. 

1 Fetches permitted, but stores not permitted. 

2 Neither fetches nor stores permitted. 
Addressing exception. 

Condition code 1 set. 

Condition code 2 set. 

Condition code 3 set. 

Protection exception. 

Page-translation exception. 

Segment-translation exception. 

T ran sla t ion- spec i fi cation exception. 



Handling of Access Exceptions 
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MULTIPLE PROGRAM-INTERRUPTION CONDITIONS 



Except for PER events* only one 
program-interruption condition is indi- 
cated with a program interruption. The 
existence of one condition* however* 
does not preclude the existence of other 
conditions. When more than one 
program-interruption condition exists* 
only the condition having the highest 
priority is identified in the intei — 
ruption code. 

With two conditions of the same 
priority* it is unpredictable which is 
indicated. In particular* the priority 
of access exceptions associated with the 
two parts of an operand that crosses a 
page or protection boundary is unpre- 
dictable and is not necessarily related 
to the sequence specified for the access 
of bytes within the operand. 

The type of ending which occurs (nulli- 
fication, suppression* or termination) 
is that which is defined for the type of 
exception that is indicated in the 
interruption code. However* if a condi- 
tion is indicated which permits 
termination* and another condition also 
exists which would cause either nullifi- 
cation or suppression* then the unit of 
operation is suppressed. 

The figure "Priority of Program- 
Interruption Conditions" lists the 
priorities of all program-interruption 
conditions other than PER events and 
exceptions associated with some of the 
more complex control instructions. All 
exceptions associated with references to 
storage for a particular instruction 
halfword or a particular operand byte 
are grouped as a single entry called 
"access." The figure "Priority of 
Access Exceptions" lists the priority of 
access exceptions for a single access. 
Thus* the second figure specifies which 
of several exceptions* encountered 
either in the access of a particular 
portion of an instruction or in any 
particular access associated with an 
operand* has highest priority, and the 
first figure specifies the priority of 
this condition in relation to other 
conditions detected in the operation. 
Similarly, the priorities for exceptions 
occurring as part of ASN translation and 
tracing are covered in the figures "Pri- 
ority of ASN-Translati on Exceptions" and 
"Priority of Trace Exceptions," respec- 
ti vely. 



For some instructions, the priority is 
shown in the individual instruction 
description. 

The relative priorities of any two 
conditions listed in the figure can be 
found by comparing the priority numbers, 
as found in the figure* from left to 
right until a mismatch is found. If the 
first inequality is between numeric 
characters, either the two conditions 
are mutually exclusive or, if both can 
occur, the condition with the smaller 
number is indicated. If the first 
inequality is between alphabetic charac- 
ters, then the two conditions are not 
exclusive, and it is unpredictable which 
is indicated when both occur. 

To understand the use of the table, 
consider an example involving the 
instruction ADD DECIMAL, which is a 
six-byte instruction. Assume that the 
first four bytes of the instruction can 
be accessed but that the instruction 
crosses a boundary so that an addressing 
exception exists for the last two bytes. 
Additionally, assume that the first 
operand addressed by the instruction 
contains invalid decimal digits and is 
in a location that can be fetched from, 
but not stored into, because of key- 
controlled protection. The three 
exceptions which could result from 
attempted execution of the ADD DECIMAL 
are: 



Priority 




Number 


Except i on 


7.B 


Access exceptions for third 




instruction halfword. 


8.B 


Access exceptions (operand 




1). 


8.D 


Data exception. 



Since the first inequality (7*8) is 
between numeric characters* the address- 
ing exception would be indicated. If* 
however* the entire ADD DECIMAL instruc- 
tion can be fetched* and only the second 
two exceptions listed above exist* then 
the inequality (B#D) is between alpha- 
betic characters* and it is 
unpredictable whether the protection 
exception or the data exception would be 
i ndi cated. 
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1. Specification exception due to any PSW error of the type that causes an 
immediate interruption. 1 

2. Specification exception due to an odd instruction address in the PSW. 

3. Access exceptions for first halfword of EXECUTE. 2 

4. Access exceptions for second halfword of EXECUTE. 2 

5. Specification exception due to target instruction of EXECUTE not being 
specified on halfword boundary. 2 

6. Access exceptions for first instruction halfword. 
7. A Access exceptions for second instruction halfword. 3 
7.B Access exceptions for third instruction halfword. 3 
7.C.1 Vectoi — operation exception. 

7.C.2 Operation exception. 

7.C.3 Privileged-operation exception for privileged instructions. 

7.C.4 Execute exception 

7.C.5 Special-operation exception 

8. A Specification exception due to conditions other than those included in 
1, 2, and 5 above. 

8.B 4 Access exceptions for an access to an operand in storage. 5 

8.C 4 Access exceptions for any other access to an operand in storage. 5 

8.D Data exception. 6 

8.E Dec imal-di vide exception. 7 

8.F Trace exceptions. 

9. Events other than PER events, exceptions which result in completion, 

and the following exceptions: fixed-point divide, floating-point divide, 
operand, and unnormalized operand. Either these exceptions and events 
are mutually exclusive or their priority is specified in the correspond- 
ing definitions. 



Priority of Program-Interruption Conditions (Part 1 of 2) 
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Explanati on : 

Numbers indicate priority* with "1" being the highest priority; letters indicate 
no priority. 

1 PSW errors which cause an immediate interruption may be introduced by a new 
PSW loaded as a result of an interruption or by the instructions LOAD PSW* 
SET SYSTEM MASK, and STORE THEN OR SYSTEM MASK. The priority shown in the 
chart is for a PSW error introduced by an interruption and may also be con- 
sidered as the priority for a PSW error introduced by the previous instruc- 
tion. The error is introduced only if the instruction encounters no other 
exceptions. The resulting interruption has a higher priority than any inter- 
ruption caused by the instruction which would have been executed next; it has 
lower priority, however, than any interruption caused by the instruction which 
introduced the erroneous PSW. 

2 Priorities 3, 4, and 5 are for the EXECUTE instruction, and priorities start- 
ing with 6 are for the target instruction. When no EXECUTE is encountered, 
priorities 3, 4 , and 5 do not apply. 

3 Separate accesses may occur for each halfword of an instruction. The second 
instruction halfword is accessed only if bits 0-1 of the instruction are not 
both zeros. The third instruction halfword is accessed only if bits 0-1 of 
of the instruction are both ones. Access exceptions for one of these half- 
words are not necessarily recognized if the instruction can be completed 
without use of the contents of the halfword or i f an exception of lower pri- 
ority can be determined without the use of the halfword. 

* As in instruction fetching, separate accesses may occur for each portion of 
an operand. Each of these accesses is of equal priority, and the two entries 
8.B and 8.C are listed to represent the relative priorities of exceptions as- 
sociated with any two of these accesses. Access exceptions for INSERT 
STORAGE KEY EXTENDED, INSERT VIRTUAL STORAGE KEY, INVALIDATE PAGE TABLE ENTRY, 
LOAD REAL ADDRESS, RESET REFERENCE BIT EXTENDED, SET STORAGE KEY EXTENDED, 
and TEST PROTECTION are also included in 8.B. 

5 For MOVE LONG and COMPARE LOGICAL LONG, an access exception for a particular 
operand can be indicated only if the R field for that operand designates an 
even-numbered register. 

6 The exception can be indicated only if the sign, digit, or digits responsi- 
ble for the exception were fetched without encountering an access exception. 

7 The exception can be indicated only if the digits used in establishing the 
exception, and also the signs, were fetched without encountering an access 
exception, only if the signs are valid, and only if the digits used in estab- 
lishing the exception are valid. 



Priority of Program-Interruption Conditions (Part 2 of 2) 



Access Excepti ons 



5. Protection (key-controlled, 
and low-address) 



page, 



The access exceptions consist of those 
exceptions which can be encountered 
while using an absolute, 
logical, real, or virtual 
access storage. Thus, with 
exceptions are: 



i nstructi on, 
address to 
DAT on, the 



1. Translation specification 

2. Segment translation 

3. Page translation 

4. Addressing 



With DAT off, the exceptions are: 

1. Addressing 

2. Protection (key-controlled and 
low-address) 

Additionally, the instructions LOAD REAL 
ADDRESS and INVALIDATE PAGE TABLE ENTRY 
can encounter a translation- 
specification exception even with DAT 
off. 
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A. Protection exception (low-address protection) due to 
a store-type operand reference with an effective ad- 
dress in the range 0-511. 

B.l. Translation-specification exception due to invalid 
encoding of bits 8-12 of control register 0. 1 

B.2. Segment-translation exception due to segment-table 
entry being outside table. 2 

B.3. Addressing exception for access to segment-table 
entry. 3 

B.4. Segment-translation exception due to I bit in seg- 
ment-table entry having the value one. 2 

B.5. Translation-specification exception due to invalid 
ones in segment-table entry. 3 

B.6. Page-translation exception due to page-table entry 
being outside table. 2 

B.7. Addressing exception for access to page-table entry. 1 

B.8. Page-translation exception due to I bit in page-table 
entry having the value one. 2 

B.9. Translation-specification exception due to invalid 
ones in page-table entry. 3 

B.10.A Protection exception (page protection) due to a 

store-type operand reference to a virtual address 
which is protected against stores. 4 

B.10.B Addressing exception for access to instruction or 
operand. 

B.ll. Protection exception (key-controlled protection) due 
to attempt to access a protected instruction or op- 
erand location. 



Explanat i on t 



Not applicable when DAT is off, except for execution of 
INVALIDATE PAGE TABLE ENTRY and for translation of operand 
address of LOAD REAL ADDRESS. 

Not applicable when DAT is off; not applicable to operand 
addresses for LOAD REAL ADDRESS and TEST PROTECTION. 

Not applicable when DAT is off except for translation of 
operand address for LOAD REAL ADDRESS. 

Not applicable when DAT is off. 
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ASN-Translati on Except i ons 



RESTART INTERRUPTION 



The ASN-translati on exceptions are those 
exceptions which are common to the proc- 
ess of translating an ASN in the 
instructions PROGRAM CALL, PROGRAM 
TRANSFER, and SET SECONDARY ASN. The 
exceptions and the priority in which 
they are detected are shown in the 
figure "Priority of ASN-Translati on 
Excepti ons." 



1. Addressing exception for access 
to ASN-f i rst-table entry. 

2. AFX-translati on exception due 
to I bit Cbit 0) in ASN-first- 
table entry being one. 

3. ASN-translati on-speci fi cation 
exception due to invalid ones 
(bits 28-31) in ASN-f i rst-table 
entry. 

4. Addressing exception for access 
to ASN-second-table entry. 

5. ASX-translati on exception due 
to I bit (bit 0) in ASN-second- 
table entry being one. 

6. ASN-translati on-speci fi cati on 
exception due to invalid ones 
(bits 30, 31, 60-63) in ASN- 
second-table entry. 



The restart interruption provides a 
means for the operator or another CPU to 
invoke the execution of a specified 
program. The CPU cannot be disabled for 
this interruption. 

A restart interruption causes the old 
PSW to be stored at real location 8 and 
a new PSW, designating the start of the 
program to be executed, to be fetched 
from real location 0. The instruction- 
length code and interruption code are 
not stored. 
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The restart interruption is initiated by 
activating the restart key. The opera- 
tion can also be initiated at the 
addressed CPU by executing a SIGNAL 
PROCESSOR instruction which specifies 
the restart order. 

When the rate control is set to the 
instruction-step position, it is unpre- 
dictable whether restart causes a unit 
of operation or additional interruptions 
to be performed after the PSWs have been 
exchanged. 



Trace Excepti ons 



The trace exceptions are those 
exceptions which can be encountered 
while forming a trace-table entry. The 
exceptions and their priority are shown 
in the figure "Priority of Trace 
Excepti ons." 



A. Protection exception (low- 
address protection) due to 
entry address being in the 
range 0-511. 

B.l Trace-table exception due to 

new entry reaching or crossing 
next 4K-byte boundary. 

B.2 Addressing exception for access 
to trace-table entry. 



Priority of Trace Exceptions 



Programmi ng Note 



To perform a restart when the CPU is in 
the check-stop state, the CPU has to be 
reset. Resetting with loss of the least 
amount of information can be accom- 
plished by means of the system-reset- 
normal key, which does not clear the 
contents of program-addressable regi s- 
ters, including the control registers, 
but causes the channel subsystem to be 
reset. The CPU-reset SIGNAL PROCESSOR 
order can be used to clear the CPU with- 
out affecting the channel subsystem. 



SUPERVISOR-CALL INTERRUPTION 



The supervisor-call interruption occurs 
when the instruction SUPERVISOR CALL is 
executed. The CPU cannot be disabled 
for the interruption, and the intei — 
ruption occurs immediately upon the 
execution of the instruction. 
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The supervisor-call interruption causes 
the old PSW to be stored at real 
location 32 and a new PSW to be fetched 
from real location 96. 

The contents of bit positions 8-15 of 
the SUPERVISOR CALL instruction are 
placed in the rightmost byte of the 
interruption code. The leftmost byte of 
the interruption code is set to zero. 
The instruction-length code is 1, unless 
the instruction was executed by means of 
EXECUTE, in which case the code is 2. 



The interruption code 
locations 138-139; 
length code is placed 
and 6 of the byte at 
with the other bits 



i s placed at real 
the instruction- 
in bit positions 5 
real location 137, 
set to zeros; and 



zeros are stored at real location 136. 



PRIORITY OF INTERRUPTIONS 
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upti on-causi ng events may 
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to a program interruption, 

an external interruption 
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might occur; or both can 

is active. Simultaneous 
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An exigent machine-check condition has 
the highest priority. When it occurs, 
the current operation is terminated or 
nullified. Program and supervisoi — call 
interruptions that would have occurred 
as a result of the current operation may 
be eliminated. Any pending repressible 
machine-check conditions may be indi- 
cated with the exigent machine-check 
interruption. Every reasonable attempt 
is made to limit the side effects of an 
exigent machine-check condition, and 
requests for external, I/O, and restart 
interruptions normally remain unaf- 
fected. 

In the absence of an exigent machine- 
check condition, interruption requests 
existing concurrently at the end of a 
unit of operation are honored, in 
descending order of priority, as 
follows: 

Supervisor call 

Program 

Repressible machine check 

External 

Input/output 

Restart 

The processing of multiple simultaneous 
interruption requests consists in stor- 
ing the old PSW and fetching the new PSW 



belonging to the interruption first 
honored. This new PSW is subsequently 
stored without the execution of any 
instructions, and the new PSW associated 
with the next interruption is fetched. 
Storing and fetching of PSWs continues 
until no more interruptions are to be 
serviced. The priority is reevaluated 
after each new PSW is loaded. Each 
evaluation takes into consideration any 
additional interruptions which may have 
become pending. Additionally, external 
and I/O interruptions, as well as 
machine-check interruptions due to 
repressible conditions, occur only if 
the current PSW at the instant of evalu- 
ation indicates that the CPU is 
interrupt ible for the cause. 

Instruction execution is resumed using 
the last-fetched PSW. The order of 
executing interruption subroutines is, 
therefore, the reverse of the order in 
which the PSWs are fetched. 

If the new PSW for a program inter- 
ruption does not specify the wait state 
and has an odd instruction address, or 
causes an access exception to be recog- 
nized, another program interruption 
occurs. Since this second interruption 
introduces the same unacceptable PSW, a 
string of interruptions is established. 
These program exceptions are recognized 
as part of the execution of the follow- 
ing instruction, and the string may be 
broken by an external, I/O, machine- 
check, or restart interruption or by the 
stop function. 

If the new PSW for a program inter- 
ruption contains a zero in bit position 
12 or contains a one in an unassigned 
bit position or if the leftmost seven 
bits of the instruction address sre not 
zeros when bit 32 indicates 24-bit 
addressing, another program interruption 
occurs. This condition is of higher 
priority than restart, I/O, external, or 
repressible machine-check conditions, or 
the stop function, and CPU reset has to 
be used to break the string of i nter- 
rupti ons. 

A string of interruptions for other 
interruption classes can also exist if 
the new PSW allows the interruption 
which has just occurred. These include 
machine-check interruptions, external 
interruptions, and I/O interruptions due 
to PCI conditions generated because of 
CCWs which form a loop. Furthermore, a 
string of interruptions involving more 
than one interruption class can exist. 
For example, assume that the CPU timer 
is negative and the CPU-timer subclass 
mask is one. If the external new PSW 
has a one in an unassigned bit position, 
and the program new PSW is enabled for 
external interruptions, then a string of 
interruptions occurs, alternating 
between external and program. Even more 
complex strings of interruptions are 
possible. As long as more interruptions 
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must be serviced, the string of inter- 
ruptions cannot be broken by employing 
the stop function; CPU reset is 
requi red. 

Similarly, CPU reset has to be invoked 
to terminate the condition that exists 
when an interruption is attempted with a 
prefix value designating a storage 
location that is not available to the 
CPU. 

Interruptions for all requests for which 
the CPU is enabled occur before the CPU 



is placed in the stopped state. When 
the CPU is in the stopped state, restart 
has the highest priority. 



Programmi nq Note 



The order in which concurrent inter- 
ruption requests are honored can b< 
changed to some extent by masking. 



f 
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CHAPTER 7^ GENERAL INSTRUCTIONS 



Data Format 7-2 

Binary-Integer Representation 7-2 

Binary Ari thmetic 7-3 

Signed Binary Arithmetic 7-3 

Addition and Subtraction 7-3 

Fixed-Point Overflow 7-3 

Unsigned Binary Arithmetic 7-3 

Signed and Logical Comparison 7-4 

Instructi ons 7-4 

ADD 7-8 

ADD HALFUIORD 7-8 

ADD LOGICAL 7-9 

AND 7-9 

BRANCH AND LINK 7-10 

BRANCH AND SAVE 7-11 

BRANCH AND SAVE AND SET MODE 7-11 

BRANCH AND SET MODE 7-12 

BRANCH ON CONDITION 7-12 

BRANCH ON COUNT 7-13 

BRANCH ON INDEX HIGH 7-13 

BRANCH ON INDEX LOW OR EQUAL 7-14 

COMPARE 7-14 

COMPARE AND FORM CODEWORD 7-15 

COMPARE AND SWAP 7-19 

COMPARE DOUBLE AND SWAP 7-19 

COMPARE HALFWORD 7-20 

COMPARE LOGICAL 7-21 

COMPARE LOGICAL CHARACTERS UNDER MASK 7-21 

COMPARE LOGICAL LONG 7-22 

CONVERT TO BINARY 7-23 

CONVERT TO DECIMAL 7-24 

DIVIDE 7-24 

EXCLUSIVE OR 7-25 

EXECUTE 7-26 

INSERT CHARACTER 7-27 

INSERT CHARACTERS UNDER MASK 7-27 

INSERT PROGRAM MASK 7-27 

LOAD 7-28 

LOAD ADDRESS 7-28 

LOAD AND TEST 7-28 

LOAD COMPLEMENT 7-28 

LOAD HALFWORD 7-29 

LOAD MULTIPLE 7-29 

LOAD NEGATIVE 7-29 

LOAD POSITIVE 7-30 

MONITOR CALL 7-30 

MOVE 7-31 

MOVE INVERSE 7-31 

MOVE LONG 7-32 

MOVE NUMERICS 7-35 

MOVE WITH OFFSET 7-35 

MOVE ZONES 7-36 

MULTIPLY 7-36 

MULTIPLY HALFWORD 7-37 

OR 7-37 

PACK 7-38 

SET PROGRAM MASK 7-39 

SHIFT LEFT DOUBLE 7-39 

SHIFT LEFT DOUBLE LOGICAL 7-40 

SHIFT LEFT SINGLE 7-40 

SHIFT LEFT SINGLE LOGICAL 7-40 

SHIFT RIGHT DOUBLE 7-41 

SHIFT RIGHT DOUBLE LOGICAL 7-41 

SHIFT RIGHT SINGLE 7-41 

SHIFT RIGHT SINGLE LOGICAL 7-42 

STORE 7-42 

STORE CHARACTER 7-42 

STORE CHARACTERS UNDER MASK 7-42 
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STORE CLOCK 7-43 

STORE HALFWORD 7-44 

STORE MULTIPLE 7-44 

SUBTRACT 7-44 

SUBTRACT HALFWORD 7-45 

SUBTRACT LOGICAL 7-45 

SUPERVISOR CALL 7-45 

TEST AND SET 7-46 

TEST UNDER MASK 7-46 

TRANSLATE 7-47 

TRANSLATE AND TEST 7-47 

UNPACK 7-48 

UPDATE TREE 7-49 



This chapter includes all the unprivi- 
leged instructions described in this 
publication other than the decimal and 
floating-point instructions. 



DATA FORMAT 



The general instructions treat data as 
being of four types: signed binary 
integers* unsigned binary integers, 
unstructured logical data, and decimal 
data. Data is treated as decimal by the 
conversion, packing, and unpacking 
instructions. Decimal data is described 
in Chapter 8, "Decimal Instructions." 

The general instructions manipulate data 
which resides in general registers or in 
storage or is introduced from the 
instruction stream. Some general 
instructions operate on data which 
resides in the PSW or the TOD clock. 

In a storage-to-storage operation the 
operand fields may be defined in such a 
way that they overlap. The effect of 
this overlap depends upon the operation. 
When the operands remain unchanged, as 
in COMPARE or TRANSLATE AND TEST, over- 
lapping does not affect the execution of 
the operation. For instructions such as 
MOVE and TRANSLATE, one operand is 
replaced by new data, and the execution 
of the operation may be affected by the 
amount of overlap and the manner in 
which data is fetched or stored. For 
purposes of evaluating the effect of 
overlapped operands, data is considered 
to be handled one eight-bit byte at a 
time. Special rules apply to the oper- 
ands of MOVE LONG and MOVE INVERSE. 



BINARY-INTEGER REPRESENTATION 



Binary integers are treated as signed or 
unsi gned. 

In an unsigned binary integer, all bits 
are used to express the absolute value 
of the number. When two unsigned binary 



integers of different lengths are added, 
the shorter number is considered to be 
extended on the left with zeros. 



In 



some 



operations, the result is 



achieved by the use of the one's comple- 
ment of the number. The one's comple- 
ment of a number is obtained by 
inverting each bit of the number, 
including the sign. 

For signed binary integers, the leftmost 
bit represents the sign, which is 
followed by the numeric field. Positive 
numbers are represented in true binary 
notation with the sign bit set to zero. 
When the value is zero, all bits are 
zeros, including the sign bit. Negative 
numbers are represented in two's- 
complement binary notation with a one in 
the sign-bit position. 

Specifically, a negative number is 
represented by the two's complement of 
the positive number of the same absolute 
value. The two's complement of a number 
is obtained by forming the one's comple- 
ment of the number, adding a value of 
one in the rightmost bit position, 
allowing a carry into the sign position, 
and ignoring any carry out of the sign 
posi ti on. 

This number representation can be 
considered the rightmost portion of an 
infinitely long representation of the 
number. When the number is positive, 
all bits to the left of the most signif- 
icant bit of the number are zeros. When 
the number is negative, these bits are 
ones. Therefore, when a signed operand 
must be extended with bits on the left, 
the extension is achieved by setting 
these bits equal to the sign bit of the 
operand. 
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value) consi sts of a 
followed by all zeros. 



sign bit of one 



> 



A signed binary integer of either sign, 
except for zero and the maximum negative 
number, can be changed to a number of 
the same magnitude but opposite sign by 



forming its 
the two's 
equi valent 
from zero, 
is zero. 



two's complement. Forming 
complement of a number is 
to subtracting the number 
The two's complement of zero 



The two's complement of the maximum 
negative number cannot be represented in 
the same number of bits. When an opera- 
tion, such as LOAD COMPLEMENT, attempts 
to produce the two's complement of the 
maximum negative number, the result is 
the maximum negative number, and a 
fixed-point-overflow exception is recog- 
nized. An overflow does not result, 
however, when the maximum negative 
number is complemented as an intermedi- 
ate result but the final result is 
within the representable range. An 
example of this case is a subtraction of 
the maximum negative number from -1. 
The product of two maximum negative 
numbers of a given length is represent- 
able as a positive number of double that 
length. 

In discussions of signed binary integers 
in this publication, a signed binary 
integer includes the sign bit. Thus, 
the expression "32-bit signed binary 
integer" denotes an integer with 31 
numeric bits and a sign bit, and the 
expression "64-bit signed binary 
integer" denotes an integer with 63 
numeric bits and a sign bit. 

In an arithmetic operation, a carry out 
of the numeric field of a signed binary 
integer is carried into the sign bit. 
However, in algebraic left-shifting, the 
sign bit does not change even if signif- 
icant numeric bits are shifted out. 



Programming Notes 



An alternate way of forming the 
two's complement of a signed binary 
integer is to invert all bits to 
the left of the rightmost one bit, 
leaving the rightmost one bit and 
all zero bits to the right of it 
unchanged. 

The numeric bits of a signed binary 
integer may be considered to repre- 
sent a positive value, with the 
sign representing a value of either 
zero or the maximum negative 
number. 



BINARY ARITHMETIC 



SIGNED BINARY ARITHMETIC 



Addi ti on and Subtracti on 



Addition of signed binary integers is 
performed by adding all bits of each 
operand, including the sign bits. When 
one of the operands is shorter, the 
shorter operand is considered to be 
extended on the left to the length of 
the longer operand by propagating the 
sign-bit value. 

Subtraction is performed by adding the 
one's complement of the second operand 
and a value of one to the first operand. 



Fixed-Point Overflow 



A fixed-point-overflow condition exists 
for signed binary addition or 
subtraction when the carry out of the 
sign-bit position and the carry out of 
the leftmost numeric bit position disa- 
gree. Detection of an overflow does not 
affect the result produced by the addi- 
tion. In mathematical terms, signed 
addition and subtraction produce a 
fixed-point overflow when the result is 
outside the range of representation for 
signed binary integers. Specifically, 
for ADD and SUBTRACT, which operate on 
32-bit signed binary integers, there is 
an overflow when the proper result would 
be greater than or equal to +2 3X or less 
than -2 31 . The actual result placed in 
the general register after an overflow 
differs from the proper result by 2 32 . 
A fixed-point overflow causes a program 
interruption if allowed by the program 
mask. 

The instructions SHIFT LEFT SINGLE and 



SHIFT LEFT DOUBLE 
when the result i s 
representation for 
gers. The actual 
that for addition 



produce an overflow 
outside the range of 
signed binary i nte- 
result differs from 
and subtraction in 

that the sign of the result remains the 

same as the original sign. 



UNSIGNED BINARY ARITHMETIC 



Addition of unsigned binary integers is 
performed by adding all bits of each 
operand. When one of the operands is 
shorter, the shorter operand is consid- 
ered to be extended on the left with 
zeros. Unsigned binary arithmetic is 
used in address arithmetic for adding 
the X, B, and D fields. (See the 
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section "Address Generation" in Chapter 
5, "Program Execution.") It is also used 
to obtain the addresses of the function 
bytes in TRANSLATE and TRANSLATE AND 
TEST. Furthermore, unsigned binary 
arithmetic is used on 32-bit unsigned 
binary integers by ADD LOGICAL and 
SUBTRACT LOGICAL. Given the same two 
operands, ADD and ADD LOGICAL produce 
the same 32-bit result. The 
instructions differ only in the intei — 
pretation of this result. ADD 
interprets the result as a signed binary 
integer and inspects it for sign, magni- 
tude, and overflow to set the condition 
code accordingly. ADD LOGICAL inter- 
prets the result as an unsigned binary 
integer and sets the condition code 
according to whether the result is zero 
and whether there was a carry out of bit 
position 0. Such a carry is not consid- 
ered an overflow, and no program 
interruption for overflow can occur for 
ADD LOGICAL. 

SUBTRACT LOGICAL differs from ADD 
LOGICAL in that the one's complement of 
the second operand and a value of one 
are added to the first operand. 



Programming Notes 



Logical addition and subtraction 
may be used to perform arithmetic 
on multiple-precision binary- 
integer operands. Thus, for 
multiple-precision addition, ADD 
LOGICAL can be used to add the 
corresponding parts of the operands 
beginning with the lowest-order 
parts. If the condition code indi- 
cates a carry, a value of one 
should be added to the sum of the 
next-highei — order parts. If the 
multiple-precision operands are 
signed, ADD should be used on the 
highest-order parts. The condition 
code then indicates any overflow or 
the proper sign and magnitude of 
the entire result; an overflow is 
also indicated by a program intei — 
ruption for fixed-point overflow if 
allowed by the program mask. If 
the multiple-precision operands are 
unsigned, ADD LOGICAL should be 
used throughout. 

Another use for ADD LOGICAL is to 
increment values representing bina- 
ry counters, which are allowed to 
wrap around from all ones to all 
zeros without indicating overflow. 



SIGNED AND LOGICAL COMPARISON 



Comparison operations determine whether 
two operands are equal or not and, for 



most operations, which of two unequal 
operands is the greater (high). 
Si gned-bi nary-compari son operations are 
provided which treat the operands as 
signed binary integers, and logical- 
comparison operations are provided which 
treat the operands as unsigned binary 
integers or as unstructured data. 



COMPARE and COMPARE 
si gned-bi nary-compari son 
These instructions are 
SUBTRACT and SUBTRACT HA 
replacing either operand, 
difference being used on 
condition code. The ope 
comparison of numbers of 



31 



or 



which differ by 2 
unlike SUBTRACT, COMPARE 
overflow. 



HALFWORD 
opera 
equi vale 
LFWORD w 
the res 
ly to se 
rati ons 
opposi t 
more, 
cannot 



are 
tions. 
nt to 
i thout 
ulting 
t the 
permi t 
e si gn 
Thus, 
cause 



Logical comparison of two operands is 
performed byte by byte, in a left-to- 
right sequence. The operands are equal 
when all their bytes &re equal. When 
the operands are unequal, the comparison 
result is determined by a left-to-right 
comparison of corresponding bit posi- 
tions in the first unequal pair of 
bytes: the zero bit in the first 
of bits indicates the low 
the one bit the high oper- 
the remaining bit and byte 
not change the comparison, 
it is not necessary to continue compar- 
ing unequal operands beyond the first 
unequal bit pair. 



unequal pai r 
operand, and 
and. Since 
positions do 



INSTRUCTIONS 



The general instructions and their 
mnemonics, formats, and operation codes 
are listed in the figure "Summary of 
General Instructions." The figure also 
indicates when the condition code is set 
and the exceptional conditions in oper- 
and designations, data, or results that 
cause a program interruption. 

A detailed definition of instruction 
formats, operand designation and length, 
and address generation is contained in 
the section "Instructions" in Chapter 5, 
"Program Execution." Exceptions to the 
general rules stated in that section are 
explicitly identified in the individual 
instruction descriptions. 

Note : In the detailed descriptions of 
the individual instructions, the mnemon- 
ic and the symbolic operand designations 
for the assembler language are shown 
with each instruction. For LOAD AND 
TEST, for example, LTR is the mnemonic 
and Ri, R 2 the operand designation. 
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Programmi ng Note 



INSERT PROGRAM MASK 
UPDATE TREE 



The general instructions in the 370-XA 
mode differ from those provided in the 
System/370 mode in that 
(1) conditional-swapping and branch- 
and-save facilities which are optional 
in the System/370 mode are part of the 
standard instruction set in the 370-XA 
mode, and (2) the following additional 
general instructions are available in 
the 370-XA mode: 

BRANCH AND SAVE AND SET MODE 
BRANCH AND SET MODE 
COMPARE AND FORM CODEWORD 



In general, bimodal addressing affects 
the general instructions only in the 
manner in which logical storage 
addresses are handled. The instructions 
BRANCH AND LINK (BAL, BALR), COMPARE 
LOGICAL LONG, LOAD ADDRESS, MOVE LONG, 
and TRANSLATE AND TEST are affected in 
that the leftmost byte of the results in 
registers is handled differently in the 
two modes. Otherwise, the general 
instructions are executed the same way 
in both the 24-bit and 31-bit addressing 
modes. 



) 
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Name 


Mne- 
monic 


Characteri sti cs 


Op 
Code 


ADD 

ADD 

ADD HALFWORD 

ADD LOGICAL 

ADD LOGICAL 


AR 

A 

AH 

ALR 

AL 


RR C 
RX C 
RX C 
RR C 
RX C 


A 
A 

A 


IF 
IF 
IF 


R 
R 
R 
R 
R 


1A 
5A 
4A 
IE 
5E 


AND 

AND 

AND (character) 

AND (immediate) 

BRANCH A^D LINK 


NR 

N 

NC 

NI 

BALR 


RR C 
RX C 
SS C 
SI C 
RR 


A 
A 
A 


T 


R 

R 
ST 
ST 
B R 


14 
54 
D4 
94 
05 


BRANCH AND LINK 

BRANCH AND SAVE 

BRANCH AND SAVE 

BRANCH AND SAVE AND SET MODE 

BRANCH AND SET MODE 


BAL 

BASR 

BAS 

BASSM 

BSM 


RX 
RR 
RX 
RR 
RR 




T 
T 


B R 
B R 
B R 
B R 
B R 


45 
OD 
4D 
OC 
OB 


BRANCH ON CONDITION 
BRANCH ON CONDITION 
BRANCH ON COUNT 
BRANCH ON COUNT 
BRANCH ON INDEX HIGH 


BCR 

BC 

BCTR 

BCT 

BXH 


RR 
RX 
RR 
RX 
RS 




* l 


B 
B 

B R 
B R 
B R 


07 
47 
06 
46 
86 


BRANCH ON INDEX LOU OR EQUAL 

COMPARE 

COMPARE 

COMPARE AND FORM CODEWORD 

COMPARE AND SWAP 


BXLE 

CR 

C 

CFC 

CS 


RS 

RR C 
RX C 
S C 
RS C 


A 

A SP 

A SP 


II GM 


B R 

R 
R ST 


87 

19 

59 

B21A 

BA 


COMPARE DOUBLE AND SWAP 

COMPARE HALFWORD 

COMPARE LOGICAL 

COMPARE LOGICAL 

COMPARE LOGICAL (character) 


CDS 

CH 

CLR 

CL 

CLC 


RS C 
RX C 
RR C 
RX C 
SS C 


A SP 
A 

A 
A 


$ 


R ST 


BB 
49 
15 
55 
D5 


COMPARE LOGICAL (immediate) 
COMPARE LOGICAL C. UNDER MASK 
COMPARE LOGICAL LONG 
CONVERT TO BINARY 
CONVERT TO DECIMAL 


CLI 

CLM 

CLCL 

CVB 

CVD 


SI C 
RS C 
RR C 
RX 
RX 


A 

A 

A SP 

A 

A 


II 

D IK 


R 
R 
ST 


95 
BD 
OF 
4F 
4E 


DIVIDE 

DIVIDE 

EXCLUSIVE OR 

EXCLUSIVE OR 

EXCLUSIVE OR (character) 


DR 

D 

XR 

X 

XC 


RR 
RX 

RR C 
RX C 
SS C 


SP 
A SP 

A 
A 


IK 
IK 


R 
R 
R 
R 
ST 


ID 
5D 
17 
57 
D7 


EXCLUSIVE OR (immediate) 

EXECUTE 

INSERT CHARACTER 

INSERT CHARACTERS UNDER MASK 

INSERT PROGRAM MASK 


XI 

EX 

IC 

ICM 

IPM 


SI C 
RX 
RX 

RS C 
RRE 


A 

AI SP 

A 

A 


EX 


ST 

R 
R 
R 


97 
44 
43 
BF 
B222 


LOAD 

LOAD 

LOAD ADDRESS 

LOAD AND TEST 

LOAD COMPLEMENT 


LR 

L 

LA 

LTR 

LCR 


RR 
RX 
RX 

RR C 
RR C 


A 


" 


R 
R 
R 
R 
R 


18 
58 
41 
12 
13 
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Name 


Mne- 
moni c 


Character! sties 


Op 
Code 


LOAD HALFWORD 
LOAD MULTIPLE 
LOAD NEGATIVE 
LOAD POSITIVE 
MONITOR CALL 


LH 

LM 

LNR 

LPR 

MC 


RX 
RS 

RR C 
RR C 
SI 


A 
A 

SP 


IF 

MO 


R 
R 
R 
R 


48 
98 
11 
10 
AF 


MOVE (character) 
MOVE (immediate) 
MOVE INVERSE 
MOVE LONG 
MOVE NUMERICS 


MVC 

MVI 

MVCIN 

MVCL 

MVN 


SS 

SI 

SS MI 

RR C 

SS 


A 

A 

A 

A SP 

A 


II 


ST 
ST 
ST 
R ST 
ST 


D2 
92 
E8 
OE 
Dl 


MOVE WITH OFFSET 
MOVE ZONES 
MULTIPLY 
MULTIPLY 
MULTIPLY HALFWORD 


MVO 

MVZ 

MR 

M 

MH 


SS 
SS 
RR 
RX 
RX 


A 
A 

SP 
A SP 
A 




ST 
ST 

R 

R 

R 


Fl 
D3 
1C 
5C 
4C 


OR 

OR 

OR (character) 

OR (immediate) 

PACK 


OR 



OC 

01 

PACK 


RR C 
RX C 
SS C 
SI C 
SS 


A 
A 
A 
A 




R 

R 
ST 
ST 
ST 


16 
56 
D6 
96 
F2 


SET PROGRAM MASK 

SHIFT LEFT DOUBLE 

SHIFT LEFT DOUBLE LOGICAL 

SHIFT LEFT SINGLE 

SHIFT LEFT SINGLE LOGICAL 


SPM 

SLDA 

SLDL 

SLA 

SLL 


RR L 
RS C 
RS 

RS C 
RS 


SP 
SP 


IF 
IF 


R 
R 
R 
R 


04 
8F 
8D 
8B 
89 


SHIFT RIGHT DOUBLE 

SHIFT RIGHT DOUBLE LOGICAL 

SHIFT RIGHT SINGLE 

SHIFT RIGHT SINGLE LOGICAL 

STORE 


SRDA 

SRDL 

SRA 

SRL 

ST 


RS C 
RS 

RS C 
RS 
RX 


SP 
SP 

A 




R 
R 
R 
R 
ST 


8E 
8C 
8A 
88 
50 


STORE CHARACTER 

STORE CHARACTERS UNDER MASK 

STORE CLOCK 

STORE HALFWORD 

STORE MULTIPLE 


STC 

STCM 

STCK 

STH 

STM 


RX 
RS 

S C 
RX 
RS 


A 
A 
A 
A 
A 


$ 


ST 
ST 
ST 
ST 
ST 


42 

BE 

B205 

40 

90 


SUBTRACT 
SUBTRACT 

SUBTRACT HALFWORD 
SUBTRACT LOGICAL 
SUBTRACT LOGICAL 


SR 

S 

SH 

SLR 

SL 


RR C 
RX C 
RX C 
RR C 
RX C 


A 
A 

A 


IF 
IF 
IF 


R 
R 
R 
R 
R 


IB 
5B 
4B 
IF 
5F 


SUPERVISOR CALL 
TEST AND SET 
TEST UNDER MASK 
TRANSLATE 
TRANSLATE AND TEST 


SVC 

TS 

TM 

TR 

TRT 


RR 

S C 
SI C 
SS 
SS C 


A 
A 
A 
A 


GM 


ST 

ST 
R 


OA 
93 
91 
DC 
DD 


UNPACK 
UPDATE TREE 


UNPK 
UPT 


SS 
E C 


A . 
A SP 


II GM 


ST 
R ST 


F3 
0102 



Summary of General Instructions (Part 2 of 3) 



> 
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Explanat i on : 



$ 

A 

AI 

B 

C 

D 

E 

EX 

GM 



IF 

II 

IK 

L 

MI 

MO 

R 

RR 

RRE 

RS 

RX 

S 

SI 

SP 

SS 

ST 

T 



Causes 
Causes 
f i elds 
Causes 
Access 



serialization and checkpoint synchronization. 

serialization and checkpoint synchronization when the M t and R a 

contain all ones and all zeros, respectively. 

seri al i zati on. 

logical addresses. 

instruction address. 



for 
for 



TRANSLATE AND TEST. 

for COMPARE AND FORM CODEWORD. 



excepti ons 
Access exceptions 
PER branch event. 
Condition code is set. 
Data exception. 
E instruction format. 
Execute exception. 

Instruction execution includes the implied use of multiple general 
regi sters: 

General registers 1 and 2 for 

General registers 1, 2, and 3 

General registers 0-5 for UPDATE TREE. 
Fixed-point-overflow exception. 
Interrupti ble instruction. 
Fixed-point-divide exception. 
New condition code is loaded. 
Move-inverse facility. 
Monitor event. 

PER general-regi stei — alteration event. 
RR instruction format. 
RRE instruction format. 
RS instruction format. 
RX instruction format. 
S instruction format. 
SI instruction format. 
Specification exception. 
SS instruction format. 
PER storage-alteration event. 

Trace exceptions (includes trace table, addressing, 
protecti on) . 



and low-address 



Summary of General Instructions (Part 3 of 3) 



ADD 



AR Ri,R : 



[RR3 



»1A» 


Ri 


R 2 



8 12 15 



R \ , Da (X 2 , B 2 ) 



CRX3 



»5A' 


Rt 


x 2 


B 2 


D 2 



8 



12 



16 



20 



31 



The second operand is added to the first 
operand, and the sum i s placed at the 
first-operand location. The operands 
and the sum are treated as 32-bit signed 
binary integers. 

When there is an overflow, the result is 
obtained by allowing any carry into the 
sign-bit position and ignoring any carry 
out of the sign-bit position, and condi- 
tion code 3 is set. If the fixed- 
point-overflow mask is one, a program 
interruption for fixed-point overflow 
occurs. 



Resulti ng Condi ti on Code : 

Result zero; no overflow 

1 Result less than zero; no over- 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Excepti ons : 

Access (fetch, operand 2 of A only) 
Fixed-point overflow 



ADD HALFWORD 



AH 



Rj ,D 2 (X 2 ,Bf) 



[RX] 



f 4A» 


Ri 


x 2 


B 2 


D 2 



8 



12 16 



20 



31 



The second operand is added to the first 
operand, and the sum is placed at the 
first-operand location. The second 
operand is two bytes in length and is 
treated as a 16-bit signed binary inte- 



rn 
\ 
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ger. The first operand and the sum are 
treated as 32-bit signed binary 
i ntegers. 

klhen there is an overflow* the result is 
obtained by allowing any carry into the 
sign-bit position and ignoring any carry 
out of the sign-bit position* and condi- 
tion code 3 is set. If the fixed- 
point-overflow mask is one* a program 
interruption for fixed-point overflow 
occurs. 

Resulti ng Condi ti on Code : 

Result zero; no overflow 

1 Result less than zero; no over- 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Excepti ons : 

Access (fetch, operand 2) 
Fixed-point overflow 



AND 



NR R t * R ! 



[RR] 



■14 f 


Ri 


R a 



8 12 15 



R t ,D 2 (X 2 ,B 2 ) CRX] 



»5«» 


Ri 


x a 


B 3 


D 2 



8 12 16 20 



NI D,(B,),I 



[SI3 



16 20 



31 



f 94 f 


I a 


B, 


D, 



31 



NC 



Programming Note 



An example of the use of the ADD HALF- 
WORD instruction is given in Appendix A 



ADD LOGICAL 



>LR R,,R a [RR] 



'IE' 


Ri 


R a 



AL 



8 12 15 



Rt*D 2 (X 2 *B<j) 



[RX] 



l 5E l 


R, 


x a 


B a 


D 2 



8 



12 



16 



20 



31 



The second operand is added to the first 
operand* and the sum is placed at the 
first-operand location. The operands 
and the sum are treated as 32-bit 
unsigned binary integers. 

Resulti ng Condi ti on Code : 

Result zero; no carry 

1 Result not zero* no carry 

2 Result zero* carry 

3 Result not zero; carry 

Program Excepti ons : 

Access (fetch* operand 2 of AL 
only) 



D 1 (L,B,),D 2 (B 2 ) 



CSS] 



D4 



B, 



D, 
-/— 



-0 



16 



20 



32 



36 47 



The AND of the first and second operands 
is placed at the first-operand location. 

The connective AND is applied to the 
operands bit by bit. A bit position in 
the result is set to one if the corre- 
sponding bit positions in both operands 
contain ones; otherwise* the result bit 
is set to zero. 

For AND (NO* each operand is processed 
left to right. When the operands ovei — 
lap* the result is obtained as if the 
operands were processed one byte at a 
time and each result byte were stored 
immediately after fetching the necessary 
operand bytes. 

For AND (NI), the first operand is one 
byte in length* and only one byte is 
stored. 

Resulti ng Condi ti on Code : 

Result zero 

1 Result not zero 
2 

3 

Program Excepti ons : 

Access (fetch* operand 2* N and NC; 
fetch and store, operand 1* NI 
and NC) 
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Programmi ng Notes 



1. 
2. 
3. 



An example of the use of the AND 
instruction is given in Appendix A. 



The AND instruction may 
set a bit to zero. 



be used to 



Accesses to the first operand of 
AND (NI) and AND (NO consist in 
fetching a first-operand byte from 
storage and subsequently storing 
the updated value. These fetch and 
store accesses to a particular byte 
do not necessarily occur one imme- 
diately after the other. Thus, the 
instruction AND cannot be safely 
used to update a location in stor- 
age if the possibility exists that 
another CPU or a channel program 
may also be updating the location. 
An example of this effect is shown 
for OR (01) in the section "Multi- 
programming and Multiprocessing 
Examples" in Appendix A. 



ILC 


CC 


Prog 
Mask 


Instruction Address 



2 4 8 31 

The instruction-length code is 1 or 2. 

The link information in the 31-bit 
addressing mode consists of the right 
half of the PSW, that is, the 
addressing-mode bit (always a one) and a 
31-bit updated instruction address, 
arranged in the following format: 



Instruction Address 



Condi ti on 
unchanged. 



Code: 



The code 



31 



remai ns 



Program Except i ons : 

Trace (R 2 field nonzero, BALR only) 



BRANCH AND LINK 



BALR R,,R 2 [RR] 



'05' 


Rt 


R* 



8 12 15 



BAL R,,D 2 (X 2 ,B 2 ) 



CRX] 



»45' 


R, 


x 2 


B* 


D a 



8 



12 



16 



20 



31 



Information from the current PSW, 
including the updated instruction 
address, is loaded as link information 
at the first-operand location. Subse- 
quently, the instruction address is 
replaced by the branch address. 

In the RX format, the second-operand 
address is used as the branch address. 
In the RR format, the contents of gener- 
al register R 2 are used to generate the 
branch address; however, when the R 2 
field is zero, the operation is 
performed without branching. The branch 
address is computed before general 
register R t is changed. 

The link information in the 24-bit 
addressing mode consists of the 
instruction-length code (ILC), the 
condition code (CC), the program-mask 
bits, and the rightmost 24 bits of the 
updated instruction address, arranged in 
the following format: 



Programmi ng Notes 



An example of th 
AND LINK instr 
Appendix A. 



4. 



he use of the BRANCH 
uction is given in 



When the R 2 field in the RR format 
is zero, the link information is 
loaded without branching. 

The BRANCH AND LINK instruction 
(BAL and BALR) is provided in the 
370-XA mode for compatibility 
purposes. It is recommended that, 
where possible, the BRANCH AND SAVE 
instruction (BAS and BASR) be used 
and BRANCH AND LINK avoided, since 
the latter places nonzero informa- 
tion in bit positions 0-7 of the 
link register in the 24-bit 
addressing mode, which may lead to 
problems. Additionally, BRANCH AND 
LINK may be slower than BRANCH AND 
SAVE because BRANCH AND SAVE always 
saves the right half of the PSW, 
and BRANCH AND LINK, which does 
not, may require additional time to 
test the addressing mode, and even 
more time, if the 24-bit addressing 
mode is in effect, to construct the 
ILC, condition code, and program 
mask to be placed in the leftmost 
byte of the link register. 

The condition-code and program-mask 
information, which is provided in 
the leftmost byte of the link 
information only in the 24-bit 
addressing mode, can be obtained in 
both the 24-bit and 31-bit address- 
ing modes by means of the INSERT 
PROGRAM MASK instruction. 
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BRANCH AND SAVE 



BASR R t ,R a [RR] 



programming note under BRANCH AND 
LINK for a discussion of the advan- 
tages of the BRANCH AND SAVE 
i nstructi on. 



"OD* 


R, 


R a 



8 12 15 



BAS 



R,,D a CX a ,B 2 ) CRX] 



'4D' 


R, 


X, 


B 2 


D 2 



8 



12 



16 



20 



31 



Bits 32-63 of the current PSW, including 
the updated instruction address, are 
saved as link information at the first- 
operand location. Subsequently, the 
instruction address is replaced by the 
branch address. 

In the 24-bit addressing mode, the link 
information consists of a 24-bit 
instruction address with eight zeros 
appended on the left. In the 31-bit 
addressing mode, the link information 
consists of a 31-bit address with a one 
appended on the left. 

In the RX format, the second-operand 
address is used as the branch address. 
In the RR format, the contents of genei — 
al register R a are used to generate the 
branch address; however, when the R 2 
field is zero, the operation is 
performed without branching. The branch 
address is computed before general 
register R t is changed. 



Condi ti on 
unchanged. 



Code: 



The code 



remains 



Program Excepti ons : 

Trace (R 2 field nonzero, BASR only) 



BRANCH AND SAVE AND SET MODE 



BASSM R t ,R 2 



ERR] 



'0C 1 


Ri 


R a 



8 



12 15 



Bits 
the 
saved 
opera 
addre 
i n th 
secon 
wi th 
if th 



32-63 of the current PSW, including 
updated instruction address, are 
as link information at the f i rst- 
nd location. Subsequently, the 
ssing mode and instruction address 
e current PSW are replaced from the 
d operand. The action associated 
the second operand is not performed 
e R 2 field is zero. 



The contents of general register R 2 
specify the new addressing mode and 
designate the branch address; however, 
when the R a field is zero, the operation 
is performed without branching and with- 
out setting the addressing mode. 



When the contents of general 
are used, bit of the reg 
fies the new addressing 
replaces bit 32 of the curr 
the branch address is genera 
contents of the register 
control of the new addressin 
new value for the PSW is com 
general register R ( is chang 



register R a 
i ster speci- 

mode and 
ent PSW, and 
ted from the 

under the 
g mode. The 
puted before 
ed. 



Condi ti on 
unchanged. 



Code: 



The code remains 



Program Excepti ons : 

Trace (R a field nonzero) 



Programmi ng Notes 



An example of the use of the BRANCH 
AND SAVE instruction is given in 
Appendix A. 

The BRANCH AND SAVE instruction 
(BAS and BASR) is intended to be 
used for linkage to programs known 
to be in the same addressing mode 
as the caller. This instruction 
should be used in place of the 
BRANCH AND LINK instruction (BAL 
and BALR). See the programming 
notes at the end of the section 
"Subroutine Linkage" in Chapter 5, 
"Program Execution," for a detailed 
discussion of these and other link- 
age instructions. See also the 



Programmi ng Notes 

1. An example of the use of the BRANCH 
AND SAVE AND SET MODE instruction 
is given in Appendix A. 



BRANCH AND SAVE AND 
intended to be the pr 
i ng instruction to 
which may operate in 
addressing mode from 
caller. See the prog 
at the end of the sec 
tine Linkage" in 
"Program Execution," f 
discussion of this an 
age instructions. 



SET MODE is 

incipal call- 

subrouti nes 

a different 

that of the 
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Chapter 5, 
or a detailed 
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BRANCH AND SET MODE 



BRANCH ON CONDITION 



BSM 



R t ,R. 



[RR] 



BCR Mt,R, 



[RR] 



'OB' 


R, 


R a 



8 



12 15 



'07' 


M, 


Ra 



8 12 15 



Bit 32 of the current PSW, the address- 
ing mode/ is inserted into the first 
operand. Subsequently the addressing 
mode and instruction address in the 
current PSW are replaced from the second 
operand. The action associated with an 
operand is not performed if the associ- 
ated R field is zero. 

The value of bit 32 of the PSW is placed 
in bit position of general register 
R t , and bits 1-31 of the register remain 
unchanged; however, when the R t field is 
zero, the bit is not inserted, and the 
contents of general register are not 
changed. 

The contents of general register R 2 
specify the new addressing mode and 
designate the branch address; however, 
when the R 2 field is zero, the operation 
is performed without branching and with- 
out setting the addressing mode. 

When the contents of general register R 2 
are used, bit of the register speci- 
fies the new addressing mode and 
replaces bit 32 of the current PSW, and 
the branch address is generated from the 
contents of the register under the 
control of the new addressing mode. The 
new value for the PSW is computed before 
general register R t is changed. 



Condi ti on 
unchanged, 



Code: 



The code 



remai ns 



Program Excepti ons : None, 



Programmi ng Notes 



1. An example of the use of the BRANCH 
AND SET MODE instruction is given 
in Appendix A. 

2. BRANCH AND SET MODE with an R, 
field of zero is intended to be the 
standard return instruction. 
BRANCH AND SAVE AND SET MODE with a 
nonzero R t field is intended to be 
used in a "glue module" to connect 
old 24-bit programs and new 
programs which may exploit bimodal 
addressing. See the programming 
note at the end of the section 
"Subroutine Linkage" in Chapter 5, 
"Program Execution," for a detailed 
discussion of this and other link- 
age instructions. 



BC 



Mi,Da(X a ,B a ) 



CRX] 



f 47" 


M, 


x 2 


B 2 


D 2 



8 



12 16 



20 



31 



The instruction address in the current 
PSW is replaced by the branch address if 
the condition code has one of the values 
specified by M t ; otherwise, normal 
instruction sequencing proceeds with the 
updated instruction address. 

In the RX format, the second-operand 
address is used as the branch address. 
In the RR format, the contents of genei — 
al register R 2 are used to generate the 
branch address; however, when the R 2 
field is zero, the operation is 
performed without branching. 

The Mi field is used as a four-bit mask. 
The four condition codes (0, 1, 2, and 
3) correspond, left to right, with the 
four bits of the mask, as follows: 



Condi ti on 
Code 


Instruction 
Bit No. of 
Mask 


Mask 
Posi ti on 
Value 



1 
2 
3 


8 
9 

10 
11 


8 
4 
2 

1 



The current condition code is used to 
select the corresponding mask bit. If 
the mask bit selected by the condition 
code is one, the branch is successful. 
If the mask bit selected is zero, normal 
instruction sequencing proceeds with the 
next sequential instruction. 

When the M, and R 2 fields of BRANCH ON 
CONDITION (BCR) are all ones and all 
zeros, respectively, a serialization and 
checkpoint-synchronization function is 
performed. 



Condi ti on 
unchanged. 



Code: 



The code 



remai ns 



Program Exceptions : None 
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Programming Notes 



An example of the use of the BRANCH 
ON CONDITION instruction is given 
in Appendix A. 

When a branch is to depend on more 
than one condition, the pertinent 
condition codes are specified in 
the mask as the sum of their mask 
position values. A mask of 12, for 
example, specifies that a branch is 
to be made when the condition code 
is or 1 . 

When all four mask bits are zeros 
or when the R 2 field in the RR 
format contains zero, the branch 
instruction is equivalent to a 
no-operation. When all four mask 
bits are ones, that is, the mask 
value is 15, the branch is uncondi- 
tional unless the R 2 field in the 
RR format is zero. 

Execution of BCR 15,0 (that is, an 
instruction with a value of 07F0 
hex) may result in significant 
performance degradation. To ensure 
optimum performance, the program 
should avoid use of BCR 15,0 except 
in cases when the serialization or 
the checkpoint-synchronization 
function is actually required. 



format, 
address 
D a ; in 
address 



Note that the relati 
RR and RX formats in 
specification is not 
operand-address speci 
branch instructions 
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specified by 
the RR forma 
is contained 
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address, but the re 
nated by R a contains 
not the operand addre 



BRANCH ON COUNT 



BCTR R,,R a CRR] 
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'06' 


Ri 


R 2 



8 12 15 



BCT R,,D a (X a ,B a ) CRX3 



»46 f 


Ri 


x 8 


B a 


D, 
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8 12 16 20 



31 
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In the RX format, the second-operand 
address is used as the branch address. 
In the RR format, the contents of gener- 
al register R a are used to generate the 
branch address; however, when the R a 
field is zero, the operation is 
performed without branching. The branch 
address is computed before general 
register R t is changed. 



Condi ti on 
unchanged. 



Code 



The 



code 



remai ns 



Program Excepti ons : None. 



Programming Notes 



An example of the use of the BRANCH 
ON COUNT instruction is given in 
Appendix A. 

The first operand and result can be 
considered as either signed or 
unsigned binary integers since the 
result of a binary subtraction is 
the same in both cases. 



3. 
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Counting is performed without 
branching when the R a field in the 
RR format contains zero. 



BRANCH ON INDEX HIGH 



BXH R,,R,,D 2 (B a ) CRS] 
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BRANCH ON INDEX LOW OR EQUAL 



Programming Notes 



BXLE R,,R 3 ,D 2 CB 2 ) 



CRS] 



•87* 


R, 


R» 


B 3 


D a 



8 



12 



16 20 



An increment is added 
and* and the sum i 
compare value. Th 
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occurs. Subsequently 
at the first-operan 
second-operand addre 
branch address. The 
registers containing 
the compare value. 
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For BRANCH ON INDEX HIGH, when the sum 
is high, the instruction address in the 
current PSW i s replaced by the branch 
address. When the sum is low or equal, 
normal instruction sequencing proceeds 
with the updated instruction address. 

For BRANCH ON INDEX LOU OR EQUAL, when 

the sum is low or equal, the instruction 

address in the current PSW is replaced 
by the branch address. When the sum is 

high, normal instruction sequencing 

proceeds with the updated instruction 
address. 

When the R 3 field is even, it designates 
a pair of registers; the contents of the 
even and odd registers of the pair are 
used as the increment and the compare 
value, respectively. When the R 3 field 
is odd, it designates a single register, 
the contents of which are used as both 
the increment and the compare value. 

For purposes of the addition and compar- 
ison, all operands and results are 
treated as 32-bit signed binary 
integers. Overflow caused by the addi- 
tion is ignored. 

The original contents of the compare- 
value register are used as the compare 
value even when that register is also 
specified to be the first-operand 
location. The branch address is 
computed before general register R t is 
changed. 



The sum i s placed at 
location, regardless 
branch is taken. 



the first-operand 
of whether the 



Condi tion 
unchanged, 



Code : The code remains 
Program Excepti ons t None. 



Several examples of the use of the 
BRANCH ON INDEX HIGH and BRANCH ON 
INDEX LOW OR EQUAL instructions are 
given in Appendix A. 

The word "index" in the names of 
these instructions indicates that 



one of the major 
incrementing and 
index value. The 
a signed binary 
used to increase 
value in general 
arbitrary amount. 



purposes is the 
testing of an 
increment, being 
integer, may be 
or decrease the 
register R t by an 



Care must be taken in the 31-bit 
addressing mode when a data area in 
storage is at the rightmost end of 
an address space and a BRANCH ON 
INDEX LOW OR EQUAL or BRANCH ON 
INDEX HIGH instruction is used to 
step upward through the data. 
Since the addition and comparison 
operations performed during the 
execution of these instructions 
treat the operands as 32-bit signed 
binary integers, the value follow- 
ing 2 31 - 1 is not 2 31 , which 
cannot be represented in that 
format, but -2 31 . The instruction 
does not provide an indication of 
such overflow. Consequently, some 
common looping techniques based on 
the use of these instructions do 
not work when a data area ends at 
address 2 3X - 1. This problem is 
illustrated in a BRANCH ON INDEX 
LOW OR EQUAL example in Appendix A. 
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The first operand is compared with the 
second operand, and the result is indi- 
cated in the condition code. The opei — 
ands are treated as 32-bit signed binary 
integers. 

Resulting Condi ti orf Code s 



Operands equal 
First operand low 
First operand high 
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Program Except i ons : 

Access (fetch, operand 2 of C only) 



COMPARE AND FORM CODEWORD 



CFC 



D,(B 2 ) 



[S3 



'B21A' 


B 2 


D 2 



16 20 



31 



General register 2 contains an index, 
which is used along with the contents of 
general registers 1 and 3 to designate 
the starting addresses of two fields in 
storage, called the first and third 
operands. The first and third operands 
are logically compared, and a codeword 
is formed for use in sort/merge algo- 
ri thms. 

The second-operand address is not used 
to address data. Bits 17-30 of the 
second-operand address, with one right- 
most and one leftmost zero appended, are 
used as a 16-bit index limit. Bit 31 of 
the second-operand address i s the 
operand-control bit. When bit 31 is 
zero, the codeword is formed from the 
high operand; when bit 31 is one, the 
codeword is formed from the low operand. 
The remainder of the second-operand 
address is ignored. 

General registers 1 and 3 contain the 
base addresses of the first and third 
operands. Bits 16-31 of general regis- 
ter 2 ar& used as an index for address- 
ing both the first and third operands. 
General registers 1, 2, and 3 must all 
initially contain even values; 
otherwise, a specification exception is 
recogni zed. 

The operation consists in comparing the 
first and third operands halfword by 
halfword and incrementing the index 
until an unequal pair of halfwords is 

or the index exceeds the index 
This proceeds in units of opera- 

between which interruptions may 



found 
limi t 
ti on, 
occur 



At the start of a unit of operation, the 
index, bits 16-31 of general register 2, 
is logically compared with the index 
limit. If the index is larger, the 
instruction is completed by placing the 
contents of general register 3, with bit 
set to one, in general register 2, and 
by setting condition code 0. 

If the index is less than or equal to 
the index limit, the index is applied to 
the first-operand and third-operand base 
addresses to locate the current pair of 
halfwords to be compared. The index, 
with 16 leftmost zeros appended, and the 
contents of general register 1 are added 



to form a 
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The current first-operand and third- 
operand halfwords are logically 
compared. If they are equal, general 
register 2 is incremented by 2, and a 
unit of operation ends. 



If the compare 
general regi ster 2 
and then shifted 1 
positions. If the 
i s zero, (1) the on 
higher halfword is 
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operand 1 was high 
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For the purpose of recognizing access 
exceptions, operand 1 and operand 3 are 
both considered to have a length equal 
to 2 more than the value of the index 
limit minus the index. When the index 
is initially larger than the index 
limit, access exceptions are not recog- 
nized for the storage operands. For 
operands longer than 4K bytes, access 
exceptions are not recognized more than 
4K bytes beyond the byte being 
processed. Access exceptions are not 
recognized more than 4K bytes beyond the 
first unequal byte and are not recog- 
nized when a specification exception 
exi sts. 

If the B 2 field designates general 
register 2, it is unpredictable whether 
or not the index limit is recomputed; 
thus, in this case the operand length is 
unpredictable. However, in no case can 
the operands exceed 2 15 bytes in length. 

Resulti ng Condi ti on Code ; 



zero and 
operand- 
operand 3 

zero and 
operand- 
operand 3 






Operands equal 
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Operand-control 


bit 




operand 1 low, 


or 




control bit one 


and 




low 
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Operand- control 


bit 




operand 1 high 


, or 




control bit one 


and 
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— 




Program 


Excepti ons: 





Access (fetch, 
Speci f i cati on 



operands 1 and 3) 
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P rogrammi ng Notes 



1. The offset of the halfword of the 
first and third operands at which 
comparison is to begin should be 
placed in bit positions 16-31 of 
general register 2 before executing 
COMPARE AND FORM CODEWORD. The 
index limit derived from the 
second-operand address should be 
the offset of the last halfword of 
the first and third operands for 
which comparison can be made. When 
the operands do not compare equal, 
the left half of the codeword 
formed in general register 2 by the 
execution of COMPARE AND FORM CODE- 
WORD gives the offset of the first 
halfword not compared. If the 
codewords compare equal in an 
UPDATE TREE operation, bit posi- 
tions ) 0-15 of general register 2 
will contain the offset at which 
another COMPARE AND FORM CODEWORD 
should resume comparison for break- 
ing codeword ties. Operand- 
control-bit values of zero or one 
are used for sorting operands in 
ascending or descending order, 
respecti vely . 

2. The condition code indicates the 
results of comparing operands up to 



32,768 bytes long. Equal operands 
result in a negative codeword in 
general register 2. A negative 
codeword also results when the 
index limit is 32,766 and the opei — 
ands that are compared differ in 
only their last two bytes. If this 
latter codeword is used by UPDATE 
TREE, an incorrect result may be 
indicated in general registers 
and 1. Therefore, the index limit 
should not exceed 32,764 when the 
resulting codeword is to be used by 
UPDATE TREE. 

The figures "Operation of COMPARE 
AND FORM CODEWORD" and "Execution 
of COMPARE AND FORM CODEWORD" 
contain summaries of the operation. 

Special precautions should be taken 
if COMPARE AND FORM CODEWORD is 
made the target of EXECUTE. See 
the programming note concerning 
i nterrupti ble instructions under 
EXECUTE. 

Further programming notes concern- 
ing i nterrupti ble instructions are 
included in the section "Interrup- 
tible Instructions" in Chapter 5, 
"Program Execution." 
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Operand- 
Control 
Bit 



Relat i on 



Resulti ng 

Condi ti on 

Code 



Result 
in GR2 



Result 
in GR1 



Result 
in GR3 



opl = op3 

opl < op3 

opl > op3 

opl = op3 

opl < op3 

opl > op3 



0GR3bl 
X, nop3 
X, nopl 
0GR3bl 
X, topi 
X, top3 



0GR3 
0GR3 



0GR1 
0GR1 



Explanati on : 

The contents of the register remain unchanged. 

0GR1 The original contents of GR1 

0GR3 The original contents of GR3 

0GR3bl The original contents of GR3 with bit set to 
one 

X Bits 0-15 of GR2 contain 2 more than the index 
of the first unequal halfword. 

nopl Bits 16-31 of GR2 contain the one's complement 
of the first unequal halfword in operand 1. 

nop3 Bits 16-31 of GR2 contain the one's complement 
of the first unequal halfword in operand 3. 

topi Bits 16-31 of GR2 contain the first unequal 
halfword in operand 1. 

top3 Bits 16-31 of GR2 contain the first unequal 
halfword in operand 3. 



> 



Operation of COMPARE AND FORM CODEWORD 
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2 x bits 17-30 of 2nd-operand address — » index limit 
Bit 31 of 2nd-operand address — > operand-control bit 





* 




No 




Bit 31 of GR1, 


GR2, and GR3 


all zeros 









Yes 



» Specification 
except i on 



Bits 16-31 of GR2 > index limit 



Yes 



No 



Unit-of- 
operati on 
boundary 



GR1 + bits 16-31 of GR2 
» lst-operand address 

GR3 + bits 16-31 of GR2 
* 3rd-operand address 

Fetch halfwords from current 
1st- and 3rd-operand locations 



GR2 + 2 



GR2 



GR3 




— * 


GR2 






1 — 


— * 
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GR2 


— 




Cond < 


;odc 





End operation 



Equal 



Compare halfwords fetched 



1st op high 



Zero 



| 1st op low 



Test operand-control bit 



Zero 



One 



Test operand-control bit 



One's complement 
of 3rd-op HW 
» TEMPHW 



-* Cond code 



lst-op HW 
> TEMPHW 

Exchange 
GR1 and GR3 



Cond code 



One's complement 
of lst-op HW 
— -> TEMPHW 

Exchange 
GR1 and GR3 

2 * Cond code 






* 
-•*- 



One 



3rd-op HW 
— ■* TEMPHW 



1 — -* Cond code 



Shift GR2 left 16 positions 
TEMPHW * bits 16-31 of GR2 



End operation 
Execution of COMPARE AND FORM CODEWORD 



4 
\ 
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COMPARE AND SWAP 



CS R,,R 3 ,D a (B a ) CRS] 



f BA* 


R, 


R 3 


B a 


D a 



8 12 16 20 



COMPARE DOUBLE AND SWAP 
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The first and second operands are 
compared. If they are equal, the third 
operand is stored at the second-operand 
location. If they are unequal, the 
second operand is loaded into the 
first-operand location. The result of 
the comparison is indicated in the 
condition code. 

For COMPARE AND SWAP, the first and 
third operands are 32 bits in length, 
with each operand occupying a general 
register. The second operand is a word 
in storage. 

For COMPARE DOUBLE AND SWAP, the first 
and third operands are 64 bits in 
length, with each operand occupying an 
even-odd pair of general registers. The 
second operand is a doubleword in stoi — 
age. 

When an equal comparison occurs, the 
third operand is stored at the second- 
operand location. The fetch of the 
second operand for purposes of compai — 
i son and the store into the second- 
operand location appear to be a block- 
concurrent i nterlocked-update reference 
as observed by other CPUs. 

When the result of the comparison is 
unequal, the second-operand location 
remains unchanged. However, on some 
models, the value may be fetched and 
subsequently stored back unchanged at 
the second-operand location. This 
update appears to be a block-concurrent 
i nterlocked-update reference as observed 
by other CPUs. 

A serialization function is performed 
before the operand is fetched and again 
after the operation is completed. 

The second operand of COMPARE AND SWAP 
must be designated on a word boundary. 
The R, and R 3 fields for COMPARE DOUBLE 
AND SWAP must each designate an even 
register, and the second operand for the 



CDS instruction must be designated on a 
doubleword boundary. Otherwise, a spec- 
ification exception is recognized. 



Result i ng Condi t i on Code ? 



First and second 
equal, second operand 
by third operand 
First and second 
unequal, first operand 
by second operand 



operands 
replaced 

operands 
replaced 



and store, operand 2) 



Program Except i ons ? 

Access (fetch 
Speci f i cati on 



Programmi ng Notes 



Several examples of the use of the 
COMPARE AND SWAP and COMPARE DOUBLE 
AND SWAP instructions are given in 
Appendix A. 

COMPARE AND SWAP can be used by CPU 
programs sharing common storage 
areas in either a multiprogramming 
or multiprocessing environment. 
Two examples are: 

a. By performing the following 
procedure, a CPU program can 
modify the contents of a stoi — 
age location even though the 
possibility exists that the CPU 
program may be interrupted by 
another CPU program that will 
update the location or that 
another CPU program may simul- 
taneously update the location. 
First, the entire word contain- 
ing the byte or bytes to be 
updated is loaded into a genei — 
al register. Next, the updated 
value is computed and placed in 
another general register. Then 
COMPARE AND SWAP is executed 
with the R t field designating 
the register that contains the 
original value and the R 3 field 
designating the register that 
contains the updated value. If 
the update has been successful, 
condition code is set. If 
the storage location no longer 
contains the original value, 
the update has not been 
successful, the general regis- 
ter designated by the R t field 
of the COMPARE AND SWAP 
instruction contains the new 
current value of the storage 
location, and condition code 1 
is set. When condition code 1 
is set, the CPU program can 
repeat the procedure using the 
new current value. 
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b. COMPARE AND SWAP can be used 
for controlled sharing of a 
common storage area, including 
the capability of leaving a 
message (in a chained list of 
messages) when the common area 
is in use. To accomplish this, 
a word in storage can be used 
as a control word, with a zero 
value in the word indicating 
that the common area is not in 
use and that no messages exist, 
a negative value indicating 
that the area is in use and 
that no messages exist, and a 
nonzero positive value indicat- 
ing that the common area is in 
use and that the value i s the 
address of the most recent 
message added to the list. 
Thus, any number of CPU 
programs desiring to seize the 
area can use COMPARE AND SWAP 
to update the control word to 
indicate that the area is in 
use or to add messages to the 
list. The single CPU program 
which has seized the area can 
also safely use COMPARE AND 
SWAP to remove messages from 
the list. 

COMPARE DOUBLE AND SWAP can be used 
in a manner similar to that 
described for COMPARE AND SWAP. In 
addition, it has another use. 
Consider a chained list, with a 
control word used to address the 
first message in the list, as 
described in programming note 2b 
above. If multiple CPU programs 
are to be permitted to delete 
messages by using COMPARE AND SWAP 
(and not just the single program 
which has seized the common area), 
there is a possibility the list 
will be incorrectly updated. This 
would occur if, for example, after 
one program has fetched the address 
of the most recent message in order 
to remove the message, another 
program removes the first two 
messages and then adds the first 
message back into the chain. The 
first program, on continuing, 
cannot easily detect that the list 
is changed. By increasing the size 
of the control word to a doubleword 
containing both the first message 
address and a word with a change 
number that is incremented for each 
modification of the list, and by 
using COMPARE DOUBLE AND SWAP to 
update both fields together, the 
possibility of the list being 
incorrectly updated is reduced to a 
negligible level. That is, an 
incorrect update can occur only if 



the first program is delayed while 
changes exactly equal in number to 
a multiple of 2 32 take place and 
only if the last change places the 
original message address in the 
control word. 

COMPARE AND SWAP and COMPARE DOUBLE 
AND SWAP do not interlock against 
storage accesses by channel 
programs. Therefore, the 
instructions should not be used to 
update a location at which a chan- 
nel program may store, since the 
channel-program data may be lost. 

For the case of a condition-code 
setting of 1, COMPARE AND SWAP and 
COMPARE DOUBLE AND SWAP may or may 
not, depending on the model, cause 
any of the following to occur for 
the second-operand location: a PER 
storage-alteration event may be 
recognized; a protection exception 
for storing may be recognized; and, 
provided no access exception 
exists, the change bit may be set 
to one. 



COMPARE HALFWORD 



CH 



Ri ,Da(X2,Ba) 



[RX] 



1491 


Ri 


X a 


B, 


D, 



8 



12 



16 



20 



31 



The first operand is compared with the 
second operand, and the result is indi- 
cated in the condition code. The second 
operand is two bytes in length and is 
treated as a 16-bit signed binary inte- 
ger. The first operand is treated as a 
32-bit signed binary integer. 

Resulting Condi ti on Code : 



Operands equal 
First operand low 
First operand high 



Program Excepti ons : 

Access (fetch, operand 2) 

Programmi ng Note 



An example of the use 
HALFWORD instruction is 
dix A. 



of the COMPARE 
given in Appen- 
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COMPARE LOGICAL 



CLR R,,R a CRR3 



'15' 


R, 


Ra 



8 12 15 



comparison may extend 
lengths of 256 bytes. 



to field 



COMPARE LOGICAL CHARACTERS UNDER MASK 



CLM 



Ri ,M 3 ,D a (B a ) 



[RS3 



CL R,,D a (X a ,B a ) 



CRX3 



l 55 t 


Ri 


x a 


B a 


D a 



8 12 16 20 



31 



CLI D t (B,),I 



ESI] 



1951 


I a 


B, 


Dt 



16 20 



31 



CLC 



DiCL,Bi),D s CB 8 ) 



CSS3 



D5 



Bt 



D, 
-/— 






8 



16 



20 



32 36 47 



The first operand is compared with the 
second operandi and the result is indi- 
cated in the condition code. 

The comparison proceeds left to right, 
byte by byte, and ends as soon as an 
inequality is found or the end of the 
fields is reached. For COMPARE LOGICAL 
(CL) and COMPARF. LOGICAL (CLC), access 
exceptions may or may not be recognized 
for the portion of a storage operand to 
the right of the first unequal byte. 

Resulting Condi tion Code ? 



Operands equal 
First operand low 
First operand high 



Program Exceptions : 

Access (fetch, operand 
CLC; fetch, operand 
CLC) 



2, CL and 
1, CLI and 



'BD' 


Ri 


M, 


B a 


D a 



8 



12 



16 



20 



31 



The first operand is compared with the 
second operand under control of a mask, 
and the result is indicated in the 
condition code. 

The contents of the M 3 field are used as 
a mask. These four bits, left to right, 
correspond one for one with the four 
bytes, left to right, of general regis- 
ter Ri . The byte positions correspond- 
ing to ones in the mask are considered 
as a contiguous field and are compared 
with the second operand. The second 
operand is a contiguous field in 
storage, starting at the second-operand 
address and equal in length to the 
number of ones in the mask. The bytes 
in the general register corresponding to 
zeros in the mask do not participate in 
the operation. 

The comparison proceeds left to right, 

byte by byte, and ends as soon as an 

inequality is found or the end of the 
fields is reached. 

When the mask is not zero, exceptions 
associated with storage-operand access 
are recognized for no more than the 
number of bytes specified by the mask. 
Access exceptions may or may not be 
recognized for the portion of a storage 
operand to the right of the first 
unequal byte. When the mask is zero, 
access exceptions are recognized for one 
byte at the second-operand address. 



Resulti ng Condi t i on Code ? 



Operands equal, or 
all zeros 
First operand low 
First operand high 



mask bi ts 



Programming Notes 



Program Excepti ons ? 

Access (fetch, operand 2) 



Examples of the use 
LOGICAL instruction 
Appendix A. 



of the COMPARE 
are given in 



COMPARE LOGICAL treats all bits of 
each operand alike as part of a 
field of unstructured logical data. 
For COMPARE LOGICAL (CLC), the 



Programmi ng Note 



An example of the use of the COMPARE 
LOGICAL CHARACTERS UNDER MASK instruc- 
tion is given in Appendix A. 
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COMPARE LOGICAL LONG 



CLCL 



R i > R i 



CRR] 



"OF 1 


Ri 


R a 



8 



12 15 



The first operand is compared with the 
second operand* and the result is indi- 
cated in the condition code. The short- 
er operand is considered to be extended 
on the right with padding bytes. 



The R\ and R 2 fields each 
even-odd pair of general 
must designate an 
register; otherwise* a 
exception is recognized. 



designate an 
registers and 
even-numbered 
speci f i cat i on 



The location of the leftmost byte of the 
first operand and second operand is 
designated by the contents of general 
registers R t and R 2 , respectively. The 
number of bytes in the first-operand and 



second-operand locations is specified by 
bits 8-31 of general registers Rt + 1 
and R a + 1, respectively. Bit positions 
0-7 of general register R a + 1 contain 
the padding byte. The contents of bit 
positions 0-7 of general register R, + 1 
are ignored. 

The handling of the addresses in general 
registers Rt and R 2 is dependent on the 
addressing mode. 



In the 24-bi 
contents of bi 
al registers 
address* and 
tions 0-7 are 
addressing mo 
positions 1-31 
and R 2 consti 
contents of bi 



t addressing mode* the 
t positions 8-31 of genei — 
Ri and R 2 constitute the 
the contents of bit posi- 
ignored. In the 31-bit 
de, the contents of bit 
of general registers R t 
tute the address* and the 
t position are ignored. 



The contents of the registers just 
described are shown in the figure "Reg- 
ister Contents for COMPARE LOGICAL 
LONG." 



Ri 
Ri + 

Ra 
R a + 




24-Bit Addressing Mode 




31-Bit Addressing Mode 






//////// 


Fi rst-Operand Address 




/ 


First-Operand Address 




t 


) 8 3J 


L C 


I 1 31 


1 


//////// 


First-Operand Length 




//////// 


First-Operand Length 




( 


) 8 3] 


L 8 31 




//////// 


Second-Operand Address 




/ 


Second-Operand Address 




( 


) 8 3j 


L 1 31 


1 


Pad 


Second-Operand Length 




Pad 


Second-Operand Length 




( 


) 8 3. 


L 1 


) 8 31 



Register Contents for COMPARE LOGICAL LONG 
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The comparison proceeds left to right , 
byte by byte, and ends as soon as an 
inequality is found or the end of the 
longer operand is reached. If the oper- 
ands are not of the same length, the 
shorter operand is considered to be 
extended on the right with the appropri- 
ate number of padding bytes. 

If both operands are of zero length, the 
operands are considered to be equal. 

The execution of the instruction is 
i nterrupti ble. When an interruption 
occurs, other than one that causes 
termination, the contents of general 
registers R t + 1 and R a + 1 are decre- 
mented by the number of bytes compared, 
and the contents of general registers Rt 
and R a are incremented by the same 
number, so that the instruction, when 
reexecuted, resumes at the point of 
interruption. The leftmost bits which 
are not part of the address in general 
registers R t and R a are set to zeros; 
the contents of bit positions 0-7 of 
general registers R t + 1 and R 2 + 1 
remain unchanged; and the condition code 
is unpredictable. If the operation is 
interrupted after the shorter operand 
has been exhausted, the length field 
pertaining to the shorter operand is 
zero, and its address is updated accord- 
i ngly . 



If the operation ends be 
inequality, the address fie 
al registers Rt and R a a 
identify the first unequal 
operand. The lengths in 
8-31 of general registers 
R a + 1 are decremented by 
bytes that were equal, 
inequality occurred with 
byte, in which case the len 
the shorter operand is set 
addresses in general regi st 
are incremented by the amo 
the corresponding length 
reduced. 



cause of an 
Ids in gener- 
t completion 

byte i n each 

bit positions 

R t + 1 and 

the number of 

unless the 

the padding 
gth field for 
to zero. The 
ers Rt and R a 
unts by which 

fields were 



If the two operands, including the 
padding byte, if necessary, are equal, 
both length fields are made zero at 
completion, and the addresses are incre- 
mented by the corresponding operand- 
length values. 

At the completion of the operation, the 
leftmost bits which are not part of the 
address in general registers Rt and R a 
are set to zeros, including the case 
when one or both of the initial length 
values are zero. The contents of bit 
positions 0-7 of general registers 
R t + 1 and R a + 1 remain unchanged. 

Access exceptions for the portion of a 
storage operand to the right of the 
first unequal byte may or may not be 
recognized. For operands longer than 2K 
bytes, access exceptions are not recog- 
nized more than 2K bytes beyond the byte 
being processed. Access exceptions are 



not indicated for locations more than 2K 
bytes beyond the first unequal byte. 

When the length of an operand is zero, 
no access exceptions are recognized for 
that operand. Access exceptions are not 
recognized for an operand if the R field 
associated with that operand is odd. 

Resulti ng Condi ti on Code : 



Operands equal, or both zero 

length 

First operand low 

First operand high 



operands 1 and 2) 



Program Excepti ons ? 

Access (fetch, 
Speci f i cat i on 



Programmi ng Notes 



An example of the use of the 
COMPARE LOGICAL LONG instruction is 
given in Appendix A. 

When the Rt and R a fields are the 
same, the operation proceeds in the 
same way as when two distinct pairs 
of registers having the same 
contents are specified, and, in the 
absence of dynamic modification of 
the operand area by another CPU or 
by a channel program, condition 
code is set. However, it is 
unpredictable whether access 
exceptions are recognized for the 
operand since the operation can be 
completed without storage being 
accessed. 

Other programming notes concerning 
i nterrupti ble instructions are 
included in the section "Interrup- 
tible Instructions" in Chapter 5, 
"Program Execution." 

Special precautions should be taken 
when COMPARE LOGICAL LONG is made 
the target of EXECUTE. See the 
programming note concerning inter- 
ruptible instructions under 
EXECUTE. 



CONVERT TO BINARY 



CVB Rt,D a (X a ,B a ) 



[RX] 



'4F' 


Rt 


x a 


B a 


D a 



8 12 16 20 



31 



The second operand is changed from deci- 
mal to binary, and the result is placed 
at the first-operand location. 
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The second operand occupies eight bytes 
in storage and has the format of packed 
decimal data, as described in Chapter 8, 
"Decimal Instructions." It is checked 
for valid sign and digit codes, and a 
data exception is recognized when an 
invalid code is detected. 

The result of the conversion is a 32-bit 
signed binary integer, which is placed 
in general register R t . The maximum 
positive number that can be converted 
and still be contained in a 32-bit 
register is 2,147,483,647; the maximum 
negative number (the negative number 
with the greatest absolute value) that 
can be converted is -2,147,483,648. For 
any decimal number outside this range, 
the operation is completed by placing 
the 32 rightmost bits of the binary 
result in the register, and a fixed- 
point-divide exception is recognized. 



Condi ti on 
unchanged. 



Code: 



The 



code remains 



Program Excepti ons * 



Access (fetch, operand 2) 

Data 

Fixed-point divide 



Programmi ng Notes 



four bits of the result represent the 

sign. A positive sign is encoded as 

1100; a negative sign is encoded as 
1101. 



Condi ti on 
unchanged 



Code: 



The code 



remains 



Program Excepti ons ? 

Access (store, operand 2) 

Programmi ng Notes 



An example of the use of 
CONVERT TO DECIMAL instruction 
given in Appendix A. 



the 
i s 



The number to be converted i s a 
32-bit signed binary integer 
obtained from a general register. 
Since 15 decimal digits are avail- 
able for the result, and the deci- 
mal equivalent of 31 bits requires 
at most 10 decimal digits, an over- 
flow cannot occur. 

The storage-operand references for 
CONVERT TO DECIMAL may be 
multiple-access references. (See 
the section "Storage-Operand 
Consistency" in Chapter 5, "Program 
Executi on.") 



1. An example of the use of the 
CONVERT TO BINARY instruction is 
given in Appendix A. 

2. When the second operand is 
negative, the result is in two's- 
complement notation. 

3. The storage-operand references for 
CONVERT TO BINARY may be multiple- 
access references. (See the 
section "Storage-Operand Consisten- 
cy" in Chapter 5, "Program 
Executi on.") 



DIVIDE 



DR R ( ,R< 



[RR] 



'ID' 


Rt 


R a 



8 12 15 



Rt>D a (X a ,B a ) 



[RX] 



CONVERT TO DECIMAL 



CVD 



R t »D a (X a ,B a ) 



tRX3 



'4E* 


R. 


x a 


B, 


D 9 



8 



12 



16 



20 



31 



The first operand is changed from binary 
to decimal, and the result is stored at 
the second-operand location. The first 
operand is treated as a 32-bit signed 
binary integer. 

The result occupies eight bytes in stor- 
age and is in the format for packed 
decimal data, as described in Chapter 8, 
"Decimal Instructions." The rightmost 



f 5D' 


R, 


x a 


B a 


D a 



8 



12 



16 



20 



31 



The doubleword first operand (the divi- 
dend) is divided by the second operand 
(the divisor), and the remainder and the 
quotient are placed at the first-operand 
locati on. 

The Rt field designates an even-odd pair 
of general registers and must designate 
an even-numbered register; otherwise, a 
specification exception is recognized. 

The dividend is treated as a 64-bit 
signed binary integer. The divisor, the 
remainder, and the quotient are treated 
as 32-bit signed binary integers. The 
remainder is placed in general register 
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Ri» and the quotient 
al register R t + 1. 



is placed in gener- 



The sign of the quotient is determined 
by the rules of algebra. The remainder 
has the same sign as the dividend, 
except that a zero quotient or a zero 
remainder is always positive. 

When the divisor is zero, or when the 
magnitudes of the dividend and divisor 
are such that the quotient cannot be 
expressed by a 32-bit signed binary 
integer, a fixed-point-divide exception 
is recognized. This includes the case 
of division of zero by zero. 



Condi ti on 
unchanged. 



Code: 



The 



code 



remai ns 



Program Excepti ons : 

Access (fetch, operand 2 of D only) 
Fixed-point divide 
Speci f i cati on 



operands are unlike; otherwise, 
result bit is set to zero. 



th< 



For EXCLUSIVE OR (XC), each operand is 
processed left to right. When the oper- 
ands overlap, the result is obtained as 
i f the operands were processed one byte 
at a time and each result byte were 
stored immediately after fetching the 
necessary operand bytes. 

For EXCLUSIVE OR (XI), the first operand 
is one byte in length, and only one byte 
is stored. 

Resulting Condi ti on Code ; 

Result zero 

1 Result not zero 
2 

3 

Program Excepti ons : 

Access (fetch, operand 2, X and XC; 
fetch and store, operand 1, XI 
and XC) 



EXCLUSIVE OR 



XR R,,R a [RR] 



'17' 


Ri 


R a 



XC 



8 12 15 



R,,D a (X a ,B a ) [RX] 



'57' 


Ri 


x a 


B a 


D a 



8 12 16 20 



31 



XI Di(B|),I a 



[SI] 



l 97 » 


I a 


B, 


D, 



16 20 



31 



D t (L,B t ),D a (B a ) 



CSS] 



D7 



Bt 



D, 



d7] 



8 



16 



20 32 36 47 



The EXCLUSIVE OR of the first and second 
operands is placed at the first-operand 
locati on. 

The connective EXCLUSIVE OR is applied 
to the operands bit by bit. A bit posi- 
tion in the result is set to one if the 
corresponding bit positions in the two 



Programmi ng Notes 



An example of the use of the EXCLU- 
SIVE OR instruction is given in 
Appendix A. 

EXCLUSIVE OR may be used to invert 

a bit, an operation particularly 

useful in testing and setting 

programmed binary bit switches. 



A field EXCLUSIVE-ORed 
becomes all zeros. 



wi th i tself 



For EXCLUSIVE OR (XR), the sequence 
A EXCLUSIVE-OR B, B EXCLUSIVE-OR A, 
A EXCLUSIVE-OR B results in the 
exchange of the contents of A and B 
without the use of an additional 
general register. 

Accesses to the first operand of 
EXCLUSIVE OR (XI) and EXCLUSIVE OR 
(XC) consist in fetching a first- 
operand byte from storage and 
subsequently storing the updated 
value. These fetch and store 
accesses to a particular byte do 
not necessarily occur one imme- 
diately after the other. Thus, 
EXCLUSIVE OR cannot be safely used 
to update a location in storage if 
the possibility exists that another 
CPU or a channel program may also 
be updating the location. An exam- 
ple of this effect is shown for OR 
(01) in the section "Multiprogram- 
ming and Multiprocessing Examples" 
in Appendix A. 
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EXECUTE 



EX 



R t , Dj CX j , B a ) 



[RX] 



»44» 


Rt 


x a 


B a 


D a 



8 



12 



16 



20 



31 



The single instruction at the second- 
operand address is modified by the 
contents of general register R t , and the 
resulting instruction* called the target 
instruction, is executed. 



When th 
of the 
second- 
bits 24 
ORing 
content 
i nstruc 
tive on 
i nstruc 
field i 



e R, 

ins 
opera 
-31 o 
does 
s of 
ti on 
ly fo 
ti on 
s zer 



f i eld i s 
tructi on 
nd addr 
f genera 
not 
general 
in stora 
r the i 
to be ex 
o, no OR 



not zero* bits 8-15 

designated by the 

ess are ORed with 

1 regi ster Ri . The 

change either the 

register R t or the 



ge, and it is effec- 
nterpretati on of the 
ecuted. When the Ri 
i ng takes place. 



The target instruction may be two, four, 
or six bytes in length. The execution 
and exception handling of the target 
instruction are exactly as if the target 
instruction were obtained in normal 
sequential operation, except for the 
instruction address and the 
instruction-length code. 

The instruction address of the current 
PSW is increased by the length of 
EXECUTE. This updated address and the 
instruction-length code of EXECUTE are 
used, for example, as part of the link 
information when the target instruction 
is BRANCH AND LINK. When the target 
instruction is a successful branching 
instruction, the instruction address of 
the current PSW i s replaced by the 
branch address specified by the target 
i nstructi on . 



When the 
EXECUTE, 
ni zed. 

The effec 
even; oth 
t i on is 
i nstructi 
length b 
f etchi ng 
it is 
except i on 
halfwords 
recogni ze 
address w 



target instruction is in turn 
an execute exception is recog- 



tive address of EXECUTE must be 
erwise, a specification excep- 
recognized. When the target 
on is two or three halfwords in 
ut can be executed without 
its second or third halfword, 
unpredictable whether access 
s are recognized for the unused 
Access exceptions &re not 
d for the second-operand 
hen the address is odd. 



The second-operand address of EXECUTE is 

sn instruction address rather than a 

logical address; thus, when the CPU is 

in the secondary-space mode, it is 



unpredictable whether the target 
instruction is fetched from the primary 
space or the secondary space. 

Condi ti on Code : The code may be set by 
the target instruction. 

Program Excepti ons : 

Access (fetch, target instruction) 

Execute 

Speci f ication 



Programmi ng Notes 



An example of the use of the 
EXECUTE instruction is given in 
Appendix A. 

The ORing of eight bits from the 
general register with the desig- 
nated instruction permits the indi- 
rect specification of the length, 
index, mask, immediate-data, regis- 
ter, or extended-op-code field. 

The fetching of the target instruc- 
tion is considered to be an 
instruction fetch for purposes of 
program-event recording and for 
purposes of reporting access 
excepti ons. 



4. 



I 6. 



An access or specification excep- 
tion may be caused by EXECUTE or by 
the target instruction. 

When an interruptible instruction 
is made the target of EXECUTE, the 
program normally should not desig- 
nate any register updated by the 
interruptible instruction as the 
R,, X a » or B a register for EXECUTE. 
Otherwise, on resumption of 
execution after an interruption, or 
if the instruction is ref etched 
without an interruption, the 
updated values of these registers 
will be used in the execution of 
EXECUTE. Similarly, the program 
should normally not let the desti- 
nation field in storage of an 
interruptible instruction include 
the location of EXECUTE, since the 
new contents of the location may be 
interpreted when resuming 
execution. 

EXECUTE should be executed in the 
secondary-space mode only if the 
virtual address of the target 
instruction translates to the same 
real address by means of both the 
primary segment table and secondary 
segment table. Otherwise, unpre- 
dictable results may occur. 
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INSERT CHARACTER 



) 



IC 



Kt»D2^X2»Ba' 



CRX3 



'43' 


Ri 


x a 


B a 


D a 



8 



12 16 



20 



31 



The byte at the second-operand location 
is inserted into bit positions 24-31 of 
general register R t . The remaining bits 
in the register remain unchanged. 



Condi tion Code : The code 
unchanged. 

Program Excepti ons : 

Access (fetch, operand 2) 

INSERT CHARACTERS UNDER MASK 



remai ns 



I CM 



R,,M 3 ,D a (B a ) 



CRS3 



*BF» 


Ri 


M* 


B 2 


D 2 



8 



12 



16 



20 



31 



Bytes from contiguous locations begin- 
ning at the second-operand address are 
inserted into general register R\ under 
control of a mask. 

The contents of the M 3 field are used as 
a mask. These four bits, left to right, 
correspond one for one with the four 
bytes, left to right, of general regis- 
ter R t . The byte positions correspon- 
ding to ones in the mask are filled, 
left to right, with bytes from succes- 
sive storage locations beginning at the 
second-operand address. When the mask 
is not zero, the length of the second 
operand is equal to the number of ones 
in the mask. The bytes in the general 
register corresponding to zeros in the 
mask remain unchanged. 

The resulting condition code is based on 
the mask and on the value of the bits 
inserted. When the mask is zero or when 
all inserted bits are zeros, the condi- 
tion code is set to 0. When the 
inserted bits are not all zeros, the 
code is set according to the leftmost 
bit of the storage operand: if this bit 
is one, the code is set to 1 ; if this 
bit is zero, the code is set to 2. 

When the mask is not zero, exceptions 
associated with storage-operand access 
are recognized only for the number of 
bytes specified by the mask. When the 
mask is zero, access exceptions are 



recognized for one byte at the second- 
operand address. 

Resulti ng Condi ti on Code : 

All inserted bits zeros, or 
mask bits all zeros 

1 Leftmost inserted bit one 

2 Leftmost inserted bit zero, and 
not all inserted bits zeros 



Program Excepti ons : 

Access (fetch, operand 2) 

Programmi ng Notes 



Examples of the use of the INSERT 
CHARACTERS UNDER MASK instruction 
are given in Appendix A. 

The condition code for INSERT CHAR- 
ACTERS UNDER MASK is defined such 
that, when the mask is 1111, the 
instruction causes the same condi- 
tion code to be set as for LOAD AND 
TEST. Thus, the instruction may be 
used as a storage-to-register 
load-and-test operation. 

INSERT CHARACTERS UNDER MASK with a 
mask of 1111 or 0001 performs a 
function similar to that of a LOAD 
(L) or INSERT CHARACTER (IC) 
instruction, respectively, with the 
exception of the condition-code 
setting. However, the performance 
of INSERT CHARACTERS UNDER MASK may 
be slower. 



INSERT PROGRAM MASK 



IPM 



Ri 



CRRE] 



'B222' 


//////// 


Ri 


//// 



16 



24 



28 31 



The condition code and program mask from 
the current PSW are inserted into bit 
positions 2-3 and 4-7, respectively, of 
general register R t . Bits and 1 of 
the register are set to zeros; bits 8-31 
are left unchanged. 

Bits 16-23 and 28-31 of the instruction 
are ignored. 



Code : The code remains 
Program Excepti ons : None. 



Condi ti on 
unchanged 
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LOAD 



Programmi ng Notes 



LR R,,R a CRR3 



'18' 


R, 


R a 



8 12 15 



Ri >D] (X{ »B] ) 



CRX] 



'58' 


R, 


X a 


B a 


D a 



8 12 16 20 



31 



The second operand i s placed unchanged 
at the first-operand location. 

Condi tion Code : The code remains 
unchanged. 

Program Excepti ons ' 

Access (fetch, operand 2 of L only) 



Programmi ng Note 



An example of the use of the LOAD 
instruction is given in Appendix A. 



LOAD ADDRESS 



LA 



R t »D a (X a »B a J 



CRX3 



'41' 


Ri 


x a 


B a 


D a 



8 



12 



16 



20 



31 



The address specified by the X a , B a , and 
D a fields is placed in general register 
Ri. The address computation follows the 
rules for address arithmetic. 

In the 24-~bit addressing mode, the 
address is placed in bit positions 8-31, 
and bits 0-7 are set to zeros. In the 
31-bit addressing mode, the address is 
placed in bit positions 1-31, and bit 
is set to zero. 

No storage references for operands take 
place, and the address is not inspected 
for access exceptions. 



An example of the use of the LOAD 
ADDRESS instruction is given in 
Appendix A. 

LOAD ADDRESS may be used to incre- 
ment the rightmost bits of a gener- 
al register, other than register 0, 
by the contents of the D a field of 
the instruction. The register to 
be incremented should be designated 
by R t and by either X a (with B a set 
to zero) or B a (with X a set to 
zero). The instruction updates 24 
bits in the 24-bit addressing mode 
and updates 31 bits in the 31-bit 
addressing mode. 



LOAD AND TEST 



LTR 



R i , R« 



ERR] 



'12' 


R, 


R a 



8 12 15 

The second operand is placed unchanged 
at the first-operand location, and the 
sign and magnitude of the second 
operand, treated as a 32-bit signed 
binary integer, &re indicated in the 
condition code. 

Resulti ng Condi ti on Code ? 



Result zero 

Result less than zero 

Result greater than zero 



Program Excepti ons : None. 



Programmi ng Note 



When the R A and R a fields designate the 
same register, the operation is equiv- 
alent to a test without data movement. 



LOAD COMPLEMENT 



LCR 



R i , Rj 



tRR3 



Condi ti on 
unchanged. 



Code: 



The code 



remains 



Program Excepti ons : None. 



'13' 


Rt 


R 2 



8 



12 15 



The two's complement of the second oper- 
and is placed at the first-operand' 
location. The second operand and result 
are treated as 32-bit signed binary 
integers. 



4 
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When there is an overflow, the result is 
obtained by allowing any carry into the 
sign-bit position and ignoring any carry 
out of the sign-bit position, and condi- 
tion code 3 is set. If the fixed- 
point-overflow mask is one, a program 
interruption for fixed-point overflow 
occurs. 

Resulti ng Condi tion Code: 

Result zero; no overflow 

1 Result less than zero; no over- 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Excepti ons : 

Fixed-point overflow 

Programmi ng Note 



The operation complements all numbers. 
Zero and the maximum negative number 
remain unchanged. An overflow condition 
occurs when the maximum negative number 
is complemented. 



LOAD MULTIPLE 



LM 



R t , R a , D 3 ( B a ) 



CRS] 



'98' 


Rt 


R 3 


B 3 


D a 



8 12 16 20 



31 



The set of general registers starting 
with general register R t and ending with 
general register R 3 is loaded from stoi — 
age beginning at the location designated 
by the second-operand address and 
continuing through as many locations as 
needed. 

The general registers are loaded in the 
ascending order of their register 
numbers, starting with general register 
R t and continuing up to and including 
general register R a , with general regis- 
ter following general register 15. 



Condi ti on 
unchanged. 



Code: 



The 



code 



remai ns 



Program Excepti ons : 

Access (fetch, operand 2) 



LOAD HALFWORD 



LH 



Rt,D2vX2,D2' 



tRXl 



»48' 


R, 


x a 


B 3 


D 3 



8 



12 16 



20 



31 



The second operand is considered to be 
extended to a 32-bit signed binary inte- 
ger and is placed at the first-operand 
location. The second operand is two 
bytes in length and is considered to be 
a 16-bit signed binary integer. The 
second operand is extended to 32 bits by 
setting each of the 16 leftmost bit 
positions equal to the sign bit of the 
storage operand. 



Condi ti on 
unchanged 



Code: 



The code 



remains 



Program Excepti ons : 

Access (fetch, operand 2) 

Programmi ng Note 



An example of the use of the LOAD HALF- 
WORD instruction is given in Appendix A. 



Programmi ng Note 



All combinations of register numbers 
specified by R t and R 3 are valid. When 
the register numbers are equal, only 
four bytes are transmitted. When the 
number specified by R 3 is less than the 
number specified by R t , the register 
numbers wrap around from 15 to 0. 



LOAD NEGATIVE 



LNR 



R i » °2 



[RR] 



•ll f 


Ri 


R 2 



8 



12 15 



The two's complement of the absolute 
value of the second operand is placed at 
the first-operand location. The second 
operand and result are treated as 32-bit 
signed binary integers. 

Resulti ng Condi ti on Code : 

Result zero 

1 Result less than zero 
2 

3 

Program Excepti ons : None. 
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Programme ng Note 



The operation complements positive 

numbers; negative numbers remain 

unchanged. The number zero remains 
unchanged. 



LOAD POSITIVE 



LPR 



R 1 , Rj 



CRR] 



'10* 


Ri 


R a 



8 



12 15 



The absolute value of the second operand 
is placed at the first-operand location. 
The second operand and the result &re 
treated as 32-bit signed binary 
i ntegers. 

When there is an overflow, the result is 
obtained by allowing any carry into the 
sign-bit position and ignoring any carry 
out of the sign-bit position, and condi- 
tion code 3 is set. If the fixed- 
point-overflow mask is one, a program 
interruption for fixed-point overflow 
occurs. 

Resulting Condi tion Code : 

I Result zero; no overflow 

1 

I 2 Result greater than zero; no 

j overflow 

3 Overflow 

Program Excepti ons : 

Fixed-point overflow 

Programmi ng Note 



The operation complements negative 
numbers; positive numbers and zero 
remain unchanged. An overflow condition 
occurs when the maximum negative number 
is complemented; the number remains 
unchanged. 



MONITOR CALL 



MC 



0,(8,), I a 



[SI] 



'AF' 


I a 


B, 


D, 



8 



16 20 



31 



A program interruption is caused if the 
appropriate monitor-mask bit in control 
register 8 is one. 



The monitor-mask bits are in bit posi- 
tions 16-31 of control register 8, which 
correspond to monitor classes 0-15, 
respecti vely. 



Bit positions 
contain a bina 
of 16 monitor 
monitor-mask b 
class specified 
a monitoi — even 
occurs. The c 
are stored at 
stored at loca 
program-i nterru 



The fi 
addres 
i f i ed 
moni to 
word a 
t i on 
ari thm 
mode, 
31-bit 
zero. 



rst-opera 
s data; i 
by the B, 
r code, 
t locatio 
follows 
eti c; in 
bits 0-7 
addressi 



12-15 in the I a field 
ry number specifying one 
ing classes. When the 
it corresponding to the 

by the I 2 field is one, 
t program interruption 
ontents of the I 2 field 
location 149, with zeros 
tion 148. Bit 9 of the 
ption code is set to one. 

nd address i s not used to 
nstead, the address spec- 

and D, fields forms the 
which is placed in the 
n 156. Address computa- 

the rules of address 

the 24-bit addressing 

are set to zeros; in the 

ng mode, bit is set to 



When the monitoi — mask bit corresponding 
to the class specified by bits 12-15 of 
the instruction is zero, no interruption 
occurs, and the instruction is executed 
as a no-operation. 

Bit positions 8-11 of the instruction 
must contain zeros; otherwise, a spec- 
ification exception is recognized. 



Condi ti on 
unchanged. 



Code: 



The code 



remai ns 



Program Excepti ons : 

Monitor event 
Speci f i cati on 



Programmi ng Notes 



MONITOR CALL provides the capabili- 
ty for passing control to a moni- 
toring program when selected points 
are reached in the monitored 
program. This is accomplished by 
implanting MONITOR CALL 
instructions at the desired points 
in the monitored program. This 
function may be useful in perform- 
ing various measurement functions; 
specifically, tracing information 
can be generated indicating which 
programs were executed, counting 
be generated indi- 
often particular 
used, and timing 
be generated indi- 
cating how long a particular 
program required for execution. 



information can 
eating how 
programs were 
information can 



The monitor masks provide a means 
of disallowing all monitor-event 
program interruptions or allowing 
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monitor-event program interruptions 
for all or selected classes. 



The monitor code provid 
of associating descripti 
tion, in addition to 
number* with each MON 
Without the use of a bas 
up to 4,096 distinct mo 
can be associated with a 
interruption. With the 
ter designated by a no 
in the Bi field, each 
interruption can be i den 
24-bit code in the 24-b 
i ng mode or a 31-bit c 
31-bit addressing mode. 



es a means 
ve informa- 

the class 
ITOR CALL, 
e regi ster, 
nitor codes 

moni tori ng 
base regi s- 
nzero value 

moni tori ng 
tified by a 
it address- 
ode in the 



MOVE 



MVI D,(B,),I : 



[SI] 



'92' 


I a 


Bt 


D, 



16 20 



31 



MVC 



Dtd.B^.DaCBa) 



tSS] 



D2 



B t 



-/— 



-/ 1 

D a 



16 



20 



32 



36 47 



The second operand is placed at the 
first-operand location. 

For MOVE (MVC), each operand is proc- 
essed left to right. When the operands 
overlap, the result is obtained as if 
the operands were processed one byte at 
a time and each result byte were stored 
immediately after fetching the necessary 
operand byte. 

For MOVE (MVI), the first operand is one 
byte in length, and only one byte is 
stored. 



Condi t i on 
unchanged. 



Code 



The 



code 



remai ns 



Program Excepti ons : 

Access (fetch, operand 2 of MVC; 
store, operand 1, MVI and MVC) 



Programmi ng Notes 



Examples of the use of the MOVE 
instruction sre given in Appendix 
A. 

It is possible to propagate one 
byte through an entire field by 
having the first operand start one 



byte to the 
operand. 



right of the second 



MOVE INVERSE 



MVCIN D,(L,B,),D a (B a ) 



CSS] 



E8 



B, 



-/— 



3 



8 



16 20 32 36 47 



The second operand i s placed at the 
first-operand location with the left- 
to-right sequence of the bytes inverted. 

The first-operand address designates the 
leftmost byte of the first operand. The 
second-operand address designates the 
rightmost byte of the second operand. 
Both operands have the same length. 



The res 

operand 

left an 

ri ght . 

around 
2 24 _ x 

or, i n 
locati o 
may, in 
around 
0, or, 
from lo 



ult is obta 
were pro 

d the first 

The seco 

from loca 

in the 24 

the 31-bit 

n 2 31 - 1. 
the 24-bit 

from locati 
in the 31 

cation 2 31 



ined as 
cessed fr 

operand 
nd opera 
ti on 
-bit add 

address 

The f 

addressi 

on 2 24 - 

-bit addr 

- 1 to lo 



i f the second 
om right to 

from left to 
nd may wrap 

to location 
ressing mode, 
i ng mode, to 
i rst operand 
ng mode, wrap 
1 to location 
essing mode, 
cation 0. 



When the operands overlap by more than 

one byte, the contents of the overlapped 

portion of the result field are unpre- 
di ctable. 

Condi ti on Code : The code remains 
unchanged. 

Program Excepti ons ? 

Access (fetch, operand 2; store, 

operand 1) 
Operation (if the move-inverse 

facility is not installed) 



Programmi ng Notes 



1. An example of the use of the MOVE 
INVERSE instruction is given in 
Appendix A. 

2. The contents of each byte moved 
remain unchanged. 

3. MOVE INVERSE is the only SS-format 
instruction for which the second- 
operand address designates the 
rightmost, instead of the leftmost, 
byte of the second operand. 

4. The storage-operand references for 
MOVE INVERSE may be multiple-access 
references. (See the section 
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"Storage-Operand Consi stency" 
Chapter 5, "Program Execution.") 



in 



MOVE LONG 



MVCL R,,R 2 



IRR1 



•OE" 


Rt 


R* 



8 



12 15 



The second operand i s placed at the 
first-operand location* provit'ed ovei — 
lapping of operand locations Mould not 
affect the final contents of the first- 
operand location. The remaining right- 
most byte positions, if any, of the 
first-operand location are filled with 
padding bytes. 



The R t and R 3 fields each 
even-odd pair of general 
must designate an 
register; otherwise, a 
exception is recognized. 



designate an 
regi sters and 
even -numbered 
specif i cati on 



The loca 
first o 
desi gnat 
regi ster 
number o 
second-o 
bits 8- 
and R 2 + 
0-7 of 
paddi ng 
t i ons 
i gnored. 



tion of the 
perand and 
ed by the 
s R t and R 
f bytes in 
perand loca 
31 of gene 
1, respect 
regi ster 
byte. The 
0-7 of r 



leftmost byte of the 
second operand i s 

contents of general 
2 , respectively. The 
the first-operand and 
tions is specified by 
ral registers R t + 1 
ively. Bit positions 

R 2 + 1 contain the 
contents of bit posi- 
egi ster R t + 1 are 



The handling of the addresses in general 
registers R t and R 2 is dependent on the 
addressing mode. In the 24-bit address- 
ing mode, the contents of bit positions 
8-31 of registers Rj and R 2 constitute 
the address, and the contents of bit 
positions 0-7 are ignored. In the 
31-bit addressing mode, the contents of 
bit positions 1-31 of registers R t and 
R 2 constitute the address, and the 
contents of bit position are ignored. 

The contents of the registers just 
described are shown in the figure "Reg- 
ister Contents for MOVE LONG." 





24-Bit Addressing Mode 




31-Bit Addressing Mode 




Ri 


//////// 


Fi rst-Operand Address 




/ 


First-Operand Address 




( 


) 8 3] 


L ( 


) 1 31 


R t + 1 


//////// 


Fi rst-Operand Length 




//////// 


First-Operand Length 




( 


) 8 3] 


L 8 31 


R 2 


//////// 


Second-Operand Address 




/ 


Second-Operand Address 




( 


) 8 3J 


L 1 31 


R 2 + 1 


Pad 


Second-Operand Length 




Pad 


Second-Operand Length 




1 


) 8 3: 


L 1 


J 8 3 


L 



Register Contents for MOVE LONG 
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the operation 

byte of the 

operand wraps 
2 24 > x (or 



The movement starts at the left end of 
both fields and proceeds to the right. 
The operation is ended when the number 
of bytes specified by bit positions 8-31 
of general register Ri + 1 have been 
moved into the first-operand location. 
If the second operand i s shorter than 
the first operand, the remaining right- 
most bytes of the first-operand location 
are filled with the padding byte. 

As part of the execution of the instruc- 
tion, the values of the two length 
fields are compared for the setting of 
the condition code, and a check is made 
for destructive overlap of the operands. 
Operands are said to overlap destruc- 
tively when the first-operand location 
is used as a source after data has been 
moved into it, assuming the inspection 
for overlap i s performed by the use of 
logical operand addresses. When the 
operands overlap destructively, no move- 
ment takes place, and condition code 3 
is set. 

Operands do not overlap destructively, 
and movement is performed, if the left- 
most byte of the first operand does not 
coincide with any of the secortd-operand 
bytes participating in 
other than the leftmost 
second operand. When an 
around from location 
2 31 - 1) to location 0, operand bytes in 
locations up to and including 2 24 - 1 
(or 2 31 - 1) are considered to be to the 
left of bytes in locations from up. 

In the 24-bit addressing mode, wrapa- 
round is from location 2 24 - 1 to 
location 0; in the 31-bit addressing 
mode, wraparound is from location 
2 31 - 1 to location 0. 

When the length specified by bit posi- 
tions 8-31 of general register Rj + 1 is 
zero, no movement takes place, and 
condition code or 1 i s set to indicate 
the relative values of the lengths. 

The execution of the instruction is 
i nterrupti ble. When an interruption 
occurs other than one that causes termi- 
nation, the contents of general regis- 
ters Ri + 1 and R a + 1 are decremented 
by the number of bytes moved, and the 
contents of general registers R t and R a 
are incremented by the same number, so 
that the instruction, when reexecuted, 
resumes at the point of interruption. 
The leftmost bits which are not part of 
the address in general registers Ri and 
R 2 are set to zeros; the contents of bit 
positions 0-7 of general registers 
Ri + 1 and R a + 1 remain unchanged; and 
the condition code is unpredictable. If 
the operation is interrupted during 
padding, the length field in general 
register R a + 1 is 0, the address in 
general register R a is incremented by 
the original contents of general regis- 



ter R a + 1» and general registers Ri and 
Ri + 1 reflect the extent of the padding 
operati on. 

When the first-operand location includes 
the location of the instruction or of 
EXECUTE, the instruction may be 
ref etched from storage and reinterpreted 
even in the absence of an interruption 
during execution. The exact point in 
the execution at which such a ref etch 
occurs is unpredictable. 

As observed by other CPUs and by channel 
programs, that portion of the first 
operand which is filled with the padding 
byte is not necessarily stored into in a 
left-to-right direction and may appear 
to be stored into more than once. 

At the completion of the operation, the 
length in general register R A + 1 is 
decremented by the number of bytes 
stored at the first-operand location, 
and the address in general register Rj 
is incremented by the same amount. The 
length in general register R a + 1 is 
decremented by the number of bytes moved 
out of the second-operand location, and 
the address in general register R a is 
incremented by the same amount. The 
leftmost bits which are not part of the 
address in general registers R t and R a 
are set to zeros, including the case 
when one or both of the original length 
values are zeros or when condition code 
3 is set. The contents of bit positions 
0-7 of general registers R t + 1 and 
R a + 1 remain unchanged. 

When condition code 3 is set, no 
exceptions associated with operand 
access are recognized. When the length 
of an operand is zero, no access 
exceptions for that operand are recog- 
nized. Similarly, when the second 
operand is longer than the first 
operand, access exceptions are not 
recognized for the part of the second- 
operand field that is in excess of the 
first-operand field. For operands long- 
er than 2K bytes, access exceptions are 
not recognized for locations more than 
2K bytes beyond the current location 
being processed. Access exceptions are 
not recognized for an operand if the R 
field associated with that operand is 
odd. Also, when the R t field is odd, 
PER storage-alteration events are not 
recognized, and no change bits are set. 

Resulti ng Condi ti on Code - 

Operand lengths equal; no 
destructive overlap 

1 First-operand length low; no 
destructive overlap 

2 First-operand length high; no 
destructive overlap 

3 No movement performed because 
of destructive overlap 
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operand 2j stor< 



Program Excepti ons ? 

Access (fetch, 

operand 1) 
Speci f i cati on 



Programme ng Notes 



An example of the use of 
LONG instruction is given 
dix A . 



the MOVE 
in Appen- 



2. MOVE LONG may be used for clearing 
storage by setting the padding byte 
to zero and the second-operand 
length to zero. On most models, 
this is the fastest instruction for 
clearing storage areas in excess of 
256 bytes. However, the stores 
associated with this clearing may 
be multiple-access stores and 
should not be used to clear an area 
if the possibility exists that 
another CPU or a channel program 
will attempt to access and use the 
area as soon as it appears to be 
zero. For more details, see the 
section "Storage-Operand Consisten- 
cy" in Chapter 5, "Program 
Execut i on ." 

3. The program should avoid specifica- 
tion of a length for either operand 
which would result in an addressing 
exception. Addressing (and also 
protection) exceptions may result 
in termination of the entire opera- 
tion, not just the current unit of 
operation. The termination may be 
such that the contents of all 
result fields are unpredictable; in 
the case of MOVE LONG, this 
includes the condition code and the 
two even-odd general-register 
pairs, as well as the first-operand 

in main storage. The 
are situations that have 
occurred on one or more 



locati on 
f ollowi ng 
actually 
models: 



a. When a protection exception 
occurs on a 4K-byte block of a 
first operand which is several 
blocks in length, stores to the 
protected block are suppressed. 
However, the move continues 
into the subsequent blocks of 
the first operand, which are 
not protected. Similarly, an 
addressing exception on a block 
does not necessarily suppress 
processing of subsequent blocks 
which are available. 

b. Some models may update the 
general regi sters only when an 
external, I/O, repressible 
machine-check, or restart 
interruption occurs, or when a 
program interruption occurs for 



5. 



7. 



which it is required to nullify 
or suppress a unit of 
operation. Thus, if, after a 
move into several blocks of the 
first operand, an addressing or 
protection exception occurs, 
the general registers may 
remain unchanged. 

When the first-operand length is 
zero, the operation consists in 
setting the condition code and 
setting the leftmost bytes of 
general registers Ri and R a to 
zero . 

When the contents of the Ri and R 2 
fields are the same, the operation 
proceeds the same way as when two 
distinct pairs of registers having 
the same contents are designated. 
Condition code is set. 



The fo 
descri pt 
movement 
where de 
exi st . 
second 
locati on 
i n the 3 
locati on 
movement 
ing case 



How 
i on 

ta 

stru 

Dep 

oper 

1-bi 
2 3 
tak 
s: 



i ng is a detai led 
of those cases in which 
kes place, that is, 
ctive overlap does not 
ending on whether the 
and wraps around from 
- 1 to location 0, or, 
t addressing mode, from 
1 - 1 to location 0, 
es place in the follow- 



a. When the second operand does 
not wrap around, movement is 
performed if the leftmost byte 
of the first operand coincides 
with or i s to the left of the 
leftmost byte of the second 
operand, or if the leftmost 
byte of the first operand is to 
the right of the rightmost 
second-operand byte participat- 
ing in the operation. 

b. When the second operand wraps 
around, movement is performed 
if the leftmost byte of the 
first operand coincides with or 
is to the left of the leftmost 
byte of the second operand, and 
if the leftmost byte of the 
first operand is to the right 
of the rightmost second-operand 
byte participating in the opei — 
at i on. 

The rightmost second-operand byte 
is determined by using the smaller 
of the f i rst-operand and second- 
operand lengths. 

When the second-operand length is 
one or zero, destructive overlap 
cannot exi st . 

Special precautions should be taken 
if MOVE LONG is made the target of 
EXECUTE. See the programming note 
concerning i nterrupt i ble instruc- 
tions under EXECUTE. 
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the program mus 
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i ntei — 
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Further programming notes concern- 
ing i nterrupti ble instructions are 
included in the section "Interrup- 
tible Instructions" in Chapter 5, 
"Program Execution." 



3. Accesses to the first operand of 
MOVE NUMERICS consist in fetching 
the rightmost four bits of each 
byte in the first operand and 
subsequently storing the updated 
value of the byte. These fetch and 
store accesses to a particular byte 
do not necessarily occur one imme- 
diately after the other. Thus, 
this instruction cannot be safely 
used to update a location in stoi — 
age if the possibility exists that 
another CPU or a channel program 
may also be updating the location. 
An example of this effect is shown 
for OR (01) in the section "Multi- 
programming and Multiprocessing 
Examples" in Appendix A. 



MOVE WITH OFFSET 



MOVE NUMERICS 



MVN 



DtCLtB^.DaCBg) 



[SS] 



'Dl 



B, 



-/— 



/ 1 



ID 



8 



16 



20 



32 



36 47 



The rightmost four bits of each byte in 
the second operand are placed in the 
rightmost bit positions of the corre- 
sponding bytes in the first operand. 
The leftmost four bits of each byte in 
the first operand remain unchanged. 

Each operand is processed left to right. 
When the operands overlap, the result is 
obtained as if the operands were proc- 
essed one byte at a time and each result 
byte were stored immediately after 
fetching the necessary operand bytes. 



Condi ti on 
unchanged. 



Code: 



The 



code 



remains 



Program Excepti ons : 

Access (fetch, operand 2; fetch and 
store, operand 1) 



Programmi ng Notes 



An example of the use of the MOVE 
NUMERICS instruction is given in 
Appendix A. 

MOVE NUMERICS moves the numeric 
portion of a decimal-data field 
that is in the zoned format. The 
zoned-decimal format is described 
in Chapter 8, "Decimal 
Instructions." The operands are 
not checked for valid sign and 
digit codes. 



MVO 



D t (Li ,Bi),D 2 (L 3 ,B 2 ) 



CSS] 



Fl 



L, 



Bt 



D, 
-/— 



-/ 1 



8 



12 



16 



20 



32 



36 47 



The second operand i s placed to the left 
of and adjacent to the rightmost four 
bits of the first operand. 

The rightmost four bits of the first 

operand are attached as the rightmost 

bits to the second operand, the second 

operand bits are offset by four bit 

positions, and the result is placed at 
the first-operand location. 



The result is obtain 
ands were processed r 
necessary, the second 
ered to be extended 
zeros. If the firs 
short to contain all 
and, the remaining 1 
the second operand i 
exceptions for the un 
second operand may o 
cated. 



ed as if the oper- 
i ght to left. When 
operand is consid- 
on the left with 
t operand i s too 
of the second opei — 
eftmost portion of 
s ignored. Access 
used portion of the 
r may not be indi- 



When the operands overlap, the result is 
obtained as if the operands were proc- 
essed one byte at a time, as if each 
result byte were stored immediately 
after fetching the necessary operand 
bytes, and as if the left digit of each 
second-operand byte were to remain 
available for the next result byte and 
need not be ref etched. 



Condi ti on 
unchanged 



Code: 



The 



code 



remai ns 



Program Excepti ons : 

Access (fetch, operand 2 J fetch and 
store, operand 1) 
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Programming Notes 



Program Except i ons : 



An example 
WITH OFFSET 
Appendix A. 



of the use of 
instruction is 



the MOVE 
given in 



MOVE WITH OFFSET may be used to 
shift packed decimal data by an odd 
number of digit positions. The 
packed-decimal format is described 
in Chapter 8, "Decimal Instruc- 
tions." The operands are not 
checked for valid sign and digit 
codes. In many cases* however, 
SHIFT AND ROUND DECIMAL may be more 
convenient to use. 

Access to the rightmost byte of the 
first operand of MOVE WITH OFFSET 
consists in fetching the rightmost 
four bits and subsequently storing 
the updated value of this byte. 
These fetch and store accesses to 
the rightmost byte of the first 
operand do not necessarily occur 
one immediately after the other. 
Thus, this instruction cannot be 
safely used to update a location in 
storage if the possibility exists 
that another CPU or a channel 
program may also be updating the 
location. An example of this 
effect is shown for OR (01) in the 
section "Multiprogramming and 
Multiprocessing Examples" in Appen- 
dix A . 

The storage-operand references for 
MOVE WITH OFFSET may be multiple- 
access references. (See the 
section "Storage-Operand Consisten- 
cy" in Chapter 5, "Program 
Executi on .") 



Access (fetch, operand 2; fetch and 
store, operand 1) 



Programmi ng Notes 



An example of the use of the MOVE 
ZONES instruction is given in 
Appendix A. 



MOVE ZONES moves the 
of a decimal field 
format. The zoned 
described in Chapter 
Instructions." The 



zoned portion 

i n the zoned 

format i s 

8, "Decimal 

operands are 



not checked 
digit codes. 



for valid sign and 



Accesses to the first operand of 
MOVE ZONES consist in fetching the 
leftmost four bits of each byte in 
the first operand and subsequently 
storing the updated value of the 
byte. These fetch and store 
accesses to a particular byte do 
not necessarily occur one imme- 
diately after the other. Thus, 
this instruction cannot be safely 
used to update a location in stor- 
age if the possibility exists that 
another CPU or a channel program 
may also be updating the location. 
An example of this effect is shown 
for the OR (01) instruction in the 
section "Multiprogramming and 
Multiprocessing Examples" in Appen- 
dix A. 



MULTIPLY 



MOVE ZONES 



MR R,,R. 



[RR] 



MVZ 



D 1 (L,B,),D a (B a ) 



CSS] 



D3 



B, 



-/ 1 



8 



16 



20 



32 



36 47 



The leftmost four bits of each byte in 
the second operand are placed in the 
leftmost four bit positions of the 
corresponding bytes in the first 
operand. The rightmost four bits of 
each byte in the first operand remain 
unchanged. 

Each operand is processed left to right. 
When the operands overlap, the result is 
obtained as if the operands were proc- 
essed one byte at a time and each result 
byte were stored immediately after the 
necessary operand byte is fetched. 



Condi ti on 
unchanged. 



Code: 



The 



code 



remai ns 



•1C 


R, 


R a 



8 12 15 



R i , D a (X a » B a ) 



£RX3 



»5C» 


R, 


x a 


B a 


D a 



8 



12 



16 



20 



31 

operand 

by the 

and the 

at the 



The second word of the first 
(multiplicand) is multiplied 
second operand (multiplier), 
doubleword product is placed 
first-operand location. 

The R1 field designates an even-odd pair 
of general registers and must designate 
an even-numbered register; otherwise, a 
specification exception is recognized. 
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Both the multiplicand and multiplier are 
treated as 32-bit signed binary 
integers. The multiplicand is taken 
from general register Ri + 1. The 
contents of general register R t are 
ignored. The product is a 64-bit signed 
binary integer, which replaces the 
contents of the even-odd pair of general 
registers designated by R,. An overflow 
cannot occur. 

The sign of the product is determined by 
the rules of algebra from the multiplier 
and multiplicand sign, except that a 
zero result is always positive. 



Condi ti on 
unchanged. 



Code: 



The code 



remains 



operand Z of H only) 



Program Excepti ons ? 

Access (fetch, 
Speci f i cati on 



Programming Notes 



An example of the use of the MULTI- 
PLY instruction is given in Appen- 
dix A. 

The significant part of the product 
usually occupies 62 bits or fewer. 
Only when two maximum negative 
numbers are multiplied are 63 
significant product bits formed. 



MULTIPLY HALFWORD 
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Ri»D a (X a »B a ) 



[RX3 
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D a 
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16 
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31 



The first operand (multiplicand) is 
multiplied by the second operand (multi- 
plier), and the product is placed at the 
first-operand location. The second 
operand is two bytes in length and is 
considered to be a 16-bit signed binary 
i nteger . 

The multiplicand is treated as a 32-bit 
signed binary integer and is replaced by 
the rightmost 32 bits of the signed- 
bi nary-i nteger product. The bits to the 
left of the 32 rightmost bits of the 
product are not tested for significance; 
no overflow indication is given. 

The sign of the product is determined by 
the rules of algebra from the multiplier 
and multiplicand sign, except that a 
zero result is always positive. 



Condi ti on 
unchanged. 



Code: 



The code 



remains 



Program Exceptions : 

Access (fetch, operand 2) 

Programmi ng Notes 



An example of the use of the MULTI- 
PLY HALFWORD instruction is given 
in Appendix A. 



OC 
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re multiplied are 47 
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rightmost 32 bits of the 
are stored unchanged, 
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of the result may differ 
true sign of the product 
se of overflow. For a 
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register R 4 are the 
part of the product in 
lement notation. 



OR 



OR Ri,Rj 



CRR] 



f 16 f 
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8 12 15 



R,,D a (X a ,B a ) CRX1 
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R, 


x 2 


B 8 


D a 



8 12 16 20 



31 



01 D,(B,),I 



LSI] 
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B, 


D, 



16 20 



31 
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CSS] 
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D, 
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16 
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32 
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The OR of the first and second operands 
is placed at the first-operand location. 

The connective OR is applied to the 
operands bit by bit. A bit position in 
the result is set to one if the corre- 
sponding bit position in one or both 



Chapter 7. General Instructions 7-37 



operands contains a one; otherwise, the 
result bit is set to zero. 

For OR (OC), each operand is processed 
left to right. When the operands ovei — 
lap, the result is obtained as if the 
operands Mere processed one byte at a 
time and each result byte were stored 
immediately after fetching the necessary 
operand bytes. 

For OR (01), the first operand is only 
one byte in length, and only one byte is 
stored. 

Result i nq Condi ti on Code ? 



Result zero 
Result not zero 



Program Excepti ons * 

Access (fetch, operand 2, and OC; 
fetch and store, operand 1, 01 
and OC) 



Programming Notes 



Examples of the use of the OR 
instruction are given in Appendix 
A. 



2. 

3. 



OR may be used to set a bit to one. 

Accesses to the first operand of OR 
(01) and OR (OC) consist in fetch- 
ing a first-operand byte from stoi — 
age and subsequently storing the 
updated value. These fetch and 
store accesses to a particular byte 
do not necessarily occur one imme- 
diately after the other. Thus, OR 
cannot be safely used to update a 
location in storage if the possi- 
bility exists that another CPU or a 
channel program may also be updat- 
ing the location. An example of 
this effect is shown in the section 
"Multiprogramming and Multiprocess- 
ing Examples" in Appendix A. 



PACK 



PACK 



D, (L, ,B, ),D 2 (L 2 ,B 2 ) 
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The format of the second operand is 
changed from zoned to packed, and the 
result is placed at the first-operand 
location. The zoned and packed formats 
are described in Chapter 8, "Decimal 
Instruct i ons." 



The second operand is treated as though 
it had the zoned format. The numeric 
bits of each byte are treated as a 
digit. The zone bits are ignored, 
except the zone bits in the rightmost 
byte, which &r& treated as a sign. 

The sign and digits are moved unchanged 
to the first operand and are not checked 
for valid codes. The sign is placed in 
the rightmost four bit positions of the 
rightmost byte of the result field, and 
the digits &re placed adjacent to the 
sign and to each other in the remainder 
of the result field. 

The result is obtained as if the oper- 
ands were processed right to left. When 
necessary, the second operand is consid- 
ered to be extended on the left with 
zeros. If the first operand is too 
short to contain all digits of the 
second operand, the remaining leftmost 
portion of the second operand is 
ignored. Access exceptions for the 
unused portion of the second operand may 
or may not be indicated. 

When the operands overlap, the result is 
obtained as if each result byte were 
stored immediately after fetching the 
necessary operand bytes. Two second- 
operand bytes are needed for each result 
byte, except for the rightmost byte of 
the result field, which requires only 
the rightmost second-operand byte. 



Condi ti on 
unchanged. 



Code: 



The code remains 



Program Exceptions : 



Access (fetch, operand 2; store, 
operand 1) 



Programmi ng Notes 



1. An example of the use of the PACK 
instruction is given in Appendix A. 

2. PACK may be used to interchange the 
two hexadecimal digits in one byte 
by specifying a zero in the Li and 
L 2 fields and the same address for 
both operands. 

3. To remove the zone bits of all 
bytes of a field, including the 
rightmost byte, both operands must 
be extended on the right with a 
dummy byte, which subsequently is 
ignored in the result field. 

4. The storage-operand references for 
PACK may be multiple-access refer- 
ences. (See the section "Storage- 
Operand Consistency" in Chapter 5, 
"Program Execution.") 
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SET PROGRAM MASK 



SPM 



R, 



£RR] 



f 04» 


R, 


//// 



8 



12 15 



I The f i rst operand i s used to set the 
condition code and the program mask of 
the current PSW. 



Bits 12-15 
i gnored. 



of the 



instruction are 



Bits 2 and 3 of general register Ri 
replace the condition code, and bits 4-7 
replace the program mask. Bits 0, 1, 
and 8-31 of general register R, are 
i gnored. 

I Condi ti on Code ? The code is set as 
j specified by bits 2 and 3 of general 
I regi ster Ri . 

Program Except i ons : None. 



Programmi ng Note s 



Bits 2-7 of the general register 
may have been loaded from the PSW 
by execution of BRANCH AND LINK in 
the 24-bit addressing mode or by 
execution of INSERT PROGRAM MASK in 
either the 24-bit or 31-bit 
addressing mode. 

SET PROGRAM MASK permits setting of 
the condition code and the mask 
bits in either the problem state or 
the supervisor state. 



The program should take 
consideration that the settin 
the program mask can have a si 
icant effect on subse 
execution of the program. Not 
do the four mask bits co 
whether the corresponding i 
ruptions occur, but the expo 
underflow and significance 
also determine the result whi 
obtai ned. 



i nto 
g of 
gni f- 
quent 

only 
ntrol 
nter- 
nent- 
masks 
ch i s 



SHIFT LEFT DOUBLE 



SLDA R,,D,(B 8 ) 



CRS] 



'8F f 


R. 


//// 


B a 


D a 



8 12 16 20 



31 



The 63-bit numeric part of the signed 
first operand is shifted left the number 



of bits specified by the second-operand 
address, and the result is placed at the 
first-operand location. 



Bits 12-15 
i gnored. 



of the instruction are 



The Ri field designates an even-odd pair 
of general registers and must designate 
an even-numbered register; otherwise, a 
specification exception is recognized. 

The second-operand address is not used 
to address data; its rightmost six bits 
indicate the number of bit positions to 
be shifted. The remainder of the 
address is ignored. 

The first operand is treated as a 64-bit 
signed binary integer. The sign posi- 
tion of the even register remains 
unchanged. The leftmost bit position of 
the odd register contains a numeric bit, 
which participates in the shift in the 
same manner as the other numeric bits. 
Zeros are supplied to the vacated bit 
positions on the right. 

If one or more bits unlike the sign bit 
are shifted out of bit position 1, an 
overflow occurs, and condition code 3 is 
set. If the fixed-point-overflow mask 
bit is one, a program interruption for 
fixed-point overflow occurs. 

Resulti ng Condi ti on Code : 

Result zero; no overflow 

1 Result less than zero; no over- 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Excepti ons : 

Fixed-point overflow 
Speci f i cati on 



Programmi ng Notes 



An example of the use of the SHIFT 
LEFT DOUBLE instruction is given in 
Appendix A. 

The eight shift instructions 
provide the following three pairs 
of alternatives: left or right, 
single or double, and signed or 
logical. The signed shifts differ 
from the logical shifts in that, in 
the signed shifts, overflow is 
recognized, the condition code is 
set, and the leftmost bit partic- 
ipates as a sign. 

A zero shift amount in the two 
signed double-shift operations 
provides a double-length sign and 
magnitude test. 
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4. The base register participating in 
the generation of the second- 
operand address permits indirect 
specification of the shift amount. 
A zero in the B 2 field indicates 
the absence of indirect shift spec- 
i f i cati on. 



SHIFT LEFT DOUBLE LOGICAL 



SLDL R,,D a (B a ) 



CRS] 



'8D f 


Ri 


//// 


B 2 


D a 



8 



12 



16 



20 



31 



The 64-bit first operand is shifted left 
the number of bits specified by the 
second-operand address, and the result 
is placed at the first-operand location. 



Bits 12-15 
i gnored. 



of the 



instruction are 



The Rj field designates an even-odd pair 
of general registers and must designate 
an even-numbered register; otherwise, a 
specification exception is recognized. 

The second-operand address i s not used 
to address data; its rightmost six bits 
indicate the number of bit positions to 
be shifted. The remainder of the 
address is ignored. 

All 64 bits of the first operand partic- 
ipate in the shift. Bits shifted out of 
bit position of the even-numbered 
register are not inspected and are lost. 
Zeros are supplied to the vacated bit 
positions on the right. 



Condi ti on 
unchanged. 



Code; 



The 



code 



remai ns 



Program Excepti ons = 
Speci f i cati on 

SHIFT LEFT SINGLE 



The second-operand address i s not used 
to address data; its rightmost six bits 
indicate the number of bit positions to 
be shifted. The remainder of the 
address is ignored. 

The first operand is treated as a 32-bit 
signed binary integer. The sign of the 
first operand remains unchanged. All 31 
numeric bits of the operand participate 
in the left shift. Zeros are supplied 
to the vacated bit positions on the 
ri ght . 

If one or more bits unlike the sign bit 
are shifted out of bit position 1, an 
overflow occurs, and condition code 3 is 
set. If the fixed-point-overflow mask 
bit is one, a program interruption for 
fixed-point overflow occurs. 

Resulti ng Condi t i on Code: 

Result zero; no overflow 

1 Result less than zero; no ovei — 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Excepti ons : 

Fixed-point overflow 

Proqrammi ng Notes 



1. An example of the use of the SHIFT 
LEFT SINGLE instruction is given in 
Appendix A. 

2. For numbers with a value greater 
than or equal to -2 30 and less than 
2 30 , a left shift of one bit posi- 
tion is equivalent to multiplying 
the number by 2. 

3. Shift amounts from 31 to 63 cause 
the entire numeric part to be 
shifted out of the register, leav- 
ing a result of the maximum nega- 
tive number or zero, depending on 
whether or not the initial contents 
were negative. 
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//// 


B a 


D a 
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16 



20 



31 



The 31-bit numeric part of the signed 
first operand is shifted left the number 
of bits specified by the second-operand 
address, and the result is placed at the 
first-operand location. 



Bits 12-15 
i gnored. 



SHIFT LEFT SINGLE LOGICAL 
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R, ,D a (B a ) 



CRS] 
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//// 


B a 


D a 
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of the instruction are | 



The 32-bit first operand is shifted left 
the number of bits specified by the 
second-operand address, and the result 
is placed at the first-operand location. 
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Bits 12-15 
ignored. 



of the instruction are 



The second-operand address i s not used 
to address data; its rightmost six bits 
indicate the number of bit positions to 
be shifted. The remainder of the 
address is ignored. 

All 32 bits of the first operand partic- 
ipate in the shift. Bits shifted out of 
bit position are not inspected and are 
lost. Zeros are supplied to the vacated 
bit positions on the right. 



Condi ti on 
unchanged. 



Code: 



The code 



remains 



Program Excepti ons ? None. 



SHIFT RIGHT DOUBLE 



SRDA R,,D a CB a ) 



[RSI 



f 8E f 


R, 


//// 


B 2 


D 2 
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12 



16 



20 



31 



The 63-bit numeric part of the signed 
first operand is shifted right the 
number of bits specified by tha second- 
operand address, and the result is 
placed at the first-operand location. 



Bits 12-15 
i gnored. 



of the 



instruction are 



The Ri field designates an even-odd pair 
of general registers and must designate 
an even-numbered register; otherwise, a 
specification exception is recognized. 

The second-operand address i s not used 
to address data; its rightmost six bits 
indicate the number of bit positions to 
be shifted. The remainder of the 
address is ignored. 

The first operand is treated as a 64-bit 
signed binary integer. The sign posi- 
tion of the even register remains 
unchanged. The leftmost bit position of 
the odd register contains a numeric bit, 
which participates in the shift in the 
same manner as the other numeric bits. 
Bits shifted out of bit position 31 of 
the odd-numbered register are not 
inspected and are lost. Bits equal to 
the sign ar& supplied to the vacated bit 
positions on the left. 

Resulti ng Condi ti on Code ? 

Result zero 

1 Result less than zero 

2 Result greater than zero 
3 



Program Excepti ons ? 
Speci f i cati on 

SHIFT RIGHT DOUBLE LOGICAL 
SRDL R,,D 2 CB 2 ) [RSI 



'8C f 


Ri 


//// 


B a 


D a 



8 



12 16 



20 



31 



The 64-bit first operand is shifted 
right the number of bits specified by 
the second-operand address, and the 
result is placed at the first-operand 
locati on. 

Bits 12-15 of the instruction are 
i gnored. 

The Ri field designates an even-odd pair 
of general registers and must designate 
an even-numbered register; otherwise, a 
specification exception is recognized. 

The second-operand address i s not used 
to address data; its rightmost six bits 
indicate the number of bit positions to 
be shifted. The remainder of the 
address is ignored. 

All 64 bits of the first operand partic- 
ipate in the shift. Bits shifted out of 
bit position 31 of the odd-numbered 
register are not inspected and are lost. 
Zeros are supplied to the vacated bit 
positions on the left. 



Condi ti on 
unchanged. 



Code; 



The 



code 



remai ns 



Program Excepti ons ? 
Speci f i cati on 

SHIFT RIGHT SINGLE 



SRA 



R t ,D 2 (B 2 ) 



[RS3 



'8A 1 


Ri 


//// 


B a 


D a 
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The 31-bit numeric part of the signed 

first operand is shifted right the 

number of bits specified by the second- 

| operand address, and the result is 

j placed at the first-operand location. 



Bits 12-15 
i gnored. 



of the 



instruction are 



The second-operand address is not used 
to address data; its rightmost six bits 
indicate the number of bit positions to 
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be shifted. The remainder 
address is ignored. 



of the 



The first operand is treated as a 32-bit 
signed binary integer. The sign of the 
first operand remains unchanged. All 31 
numeric bits of the operand participate 
in the right shift. Bits shifted out of 
bit position 31 &re not inspected and 
are lost. Bits equal to the sign are 
supplied to the vacated bit positions on 
the left. 

Resulting Condi ti on Code : 

Result srero 

1 Result less than zero 

2 Result greater than zero 
3 

Program Exceptions: None. 



Programmi ng Notes 



A right shift of one bit position 
is equivalent to division by 2 with 
rounding downward. When an even 
number is shifted right one posi- 
tion> the result is equivalent to 
dividing the number by 2. When an 
odd number is shifted right one 
position, the result is equivalent 
to dividing the next lower number 
by 2. For example, +5 shifted 
right by one bit position yields 
+2, whereas -5 yields -3. 

Shift amounts from 31 to 63 cause 
the entire numeric part to be 
shifted out of the register, leav- 
ing a result of -1 or zero, depend- 
ing on whether or not the initial 
contents were negative. 



SHIFT RIGHT SINGLE LOGICAL 



SRL 



Rt ,D 3 (B 3 ) 



[RS3 



'88' 


Ri 


//// 


B 2 


D 2 



8 



12 



16 



20 



31 



The 32-bit first operand is shifted 
right the number of bits specified by 
the second-operand address, and the 
result is placed at the first-operand 
locati on. 



Bits 12-15 
i gnored. 



of the instruction are 



The second-operand address i s not used 
to address data; its rightmost six bits 
indicate the number of bit positions to 
be shifted. The remainder of the 
address is ignored. 



All 32 bits of the first operand partic- 
ipate in the shift. Bits shifted out of 
bit position 31 are not inspected and 
are lost. Zeros are supplied to the 
vacated bit positions on the left. 



Condi ti on 
unchanged. 



Code: 



The code 



remai ns 



Program Excepti ons : None. 



STORE 



ST 



R 1 ;Dj (X2 JOj ) 



CRX3 



♦50* 


R1 


x 2 


B a 


D a 



8 12 16 



20 



31 



The first operand is stored at the 
second-operand location. 

The 32 bits in the general register are 
placed unchanged at the second-operand 
locati on. 

Condi ti on Code : The code remains 
unchanged. 

Program Excepti ons : 

Access (store, operand 2) 



STORE CHARACTER 



STC R,,D a (X a ,B a ) 



CRX3 



♦42' 


R. 


X a 


B 8 


D a 



8 12 16 20 



31 



Bits 24-31 of general register Rj are 
placed unchanged at the second-operand 
location. The second operand is one 
byte in length. 

Condi tion Code : The code remains 
unchanged. 

Program Excepti ons : 

Access (store, operand 2) 



STORE CHARACTERS UNDER MASK 



STCM R,,N 3 ,D a (B a ) CRS] 



»BE» 


R, 


M 3 


B 2 


D 2 



8 12 16 20 



31 



7-42 370-XA Principles of Operation 



) 



Bytes selected from general register Ri 
under control of a mask are placed at 
contiguous byte locations beginning at 
the second-operand address. 



The contents of the M 
a mask. These four b 
correspond one for 
bytes, left to right, 
ter R] . The bytes co 
in the mask are place 
at successive and 
locations beginning 
operand address. Wh 
zero, the length of 
is equal to the numb 
mask. The contents 
register remain uncha 



3 field are used as 
its, left to right, 
one with the four 

of general regi s- 
rresponding to ones 
d in the same order 
contiguous storage 

at the second- 
en the mask is not 
the second operand 
er of ones in the 
of the general 
nged. 



When the mask is not zero, exceptions 
associated with storage-operand accesses 
are recognized only for the number of 
bytes specified by the mask. 

When the mask is zero, the single byte 
designated by the second-operand address 
remains unchanged; however, on some 
models, the value may be fetched and 
subsequently stored back unchanged at 
the same storage location. This update 
appears to be an i nterlocked-update 
reference as observed by other CPUs. 



Condi ti on Code ? 
unchanged. 



The code 



rental ns 



Program Excepti ons : 

Access (store, operand 2) 

Programmi ng Notes 



An example of the use of the STORE 
CHARACTERS UNDER MASK instruction 
is given in Appendix A. 

STORE CHARACTERS UNDER MASK with a 
mask of 0111 may be used to store a 
three-byte address, for example, in 
modifying the address in a CCW. 

STORE CHARACTERS UNDER MASK with a 
mask of 1111, 0011, or 0001 
performs the same function as 
STORE, STORE HALFWORD, or STORE 
CHARACTER, respectively. However, 
on most models, the performance of 
STORE CHARACTERS UNDER MASK is 
slower. 

Using STORE CHARACTERS UNDER MASK 
with a zero mask should be avoided 
since this instruction, depending 
on the model, may perform a fetch 
and store of the single byte desig- 
nated by the second-operand 
address. This reference is not 
interlocked against accesses by 
channel programs. In addition, it 
may cause any of the following to 
occur for the byte designated by 



the second-operand address: a PER 
storage-alteration event may be 
recognized; access exceptions may 
be recognized; and, provided no 
access exceptions exist, the change 
bit may be set to one. 



STORE CLOCK 



STCK D 2 (B 2 ) 



CS] 



f B205 f 


B a 


D a 



16 



20 



31 



The current value of the TOD clock is 
stored at the eight-byte field desig- 
nated by the second-operand address, 
provided the clock is in the set, 
stopped, or not-set state. 

Zeros are stored for the rightmost bit 
positions that are not provided by the 
clock. 

Zeros are stored at the operand location 
when the clock is in the error state or 
in the not-operational state. 

The quality of the clock value stored by 
the instruction is indicated by the 
resultant condition-code setting. 

A serialization function is performed 
before the value of the clock is fetched 

| and again after the value is placed in 

| storage. 

Resulti ng Condi ti on Code ? 

Clock in set state 

1 Clock in not-set state 

2 Clock in error state 

3 Clock in stopped state or not- 
operational state 

Program Excepti ons : 

Access (store, operand 2) 

Programmi ng Notes 



Bit position 31 of the clock is 
incremented every 1.048576 seconds; 
hence, for timing applications 
involving human responses, the 
leftmost clock word may provide 
sufficient resolution. 

Condition code normally indicates 
that the clock has been set by the 
control program. Accordingly, the 
value may be used in elapsed-time 
measurements and as a valid time- 
of-day and calendar indication. 
Condition code 1 indicates that the 
clock value is the elapsed time 
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since the power for the clock was 
turned on. In this case, the value 
may be used in elapsed-time meas- 
urements but is not a valid time- 
of-day indication. Condition codes 
2 and 3 mean that the value 
provided by STORE CLOCK cannot be 
used for time measurement or indi- 
cati on. 

Condition code 3 indicates that the 
clock is in either the stopped 
state or the not-operational state. 
These two states can normally be 
distinguished because &r\ all-zero 
value is stored when the clock is 
in the not-operational state. 

If a problem program written for 
the 370-XA mode i s to be executed 
also on a system in the System/370 
mode> then the program should take 
into account that, in the 
System/370 mode, the value stored 
when the condition code is 2 is not 
necessarily zero. 



starting with general register R, and 
continuing up to and including general 
register R 3 , with general register 
following general register 15. 



Condi ti on Code ? 
unchanged. 



The code 



remains 



Program Excepti ons : 

Access (store, operand 2) 

Programmi na Note 



An example of the use of the STORE 
MULTIPLE instruction is given in Appen- 
dix A. 



SUBTRACT 



SR R i , R < 



CRR] 



STORE HALFWORD 



STH 



R i * 0} (X] > B 3 ) 



CRX1 



'10' 


R, 


x 3 


B a 


D 2 



8 



12 



16 20 



31 



Bits 16-31 of general register Rj are 
placed unchanged at the second-operand 
location. The second operand is two 
bytes in length. 



Condi ti on 
unchanged. 



Code: 



The code 



remai ns 



Program Excepti ons : 

Access (store, operand 2) 



STORE MULTIPLE 



STM 



Ri ,R 3 ,D 3 (B 3 ) 



CRS3 



»90 f 


R, 


R 3 


B 3 


D 2 



8 



12 



16 



20 



31 



The contents of the set of general 
registers starting with general register 
Ri and ending with general register R 3 
are placed in the storage area beginning 
at the location designated by the 
second-operand address and continuing 
through as many locations as needed. 

The general registers are stored in the 
ascending order of register numbers, 



'IB 1 


Rt 


R a 



8 12 15 



R,,D 2 (X 3 ,B 2 ) [RX] 



f 5B f 


R, 


X a 


B 3 


D 3 



8 12 



16 



20 



31 



The second operand is subtracted from 
the first operand, and the difference is 
placed at the first-operand location. 
The operands and the difference are 
treated as 32-bit signed binary 
i ntegers. 

When there is an overflow, the result is 
obtained by allowing any carry into the 
sign-bit position and ignoring any carry 
out of the sign-bit position, and condi- 
tion code 3 is set. If the fixed- 
point-overflow mask is one, a 
interruption for fixed-point 
occurs. 

Resulting Condition Code: 



program 
overflow 



Result 

Result 

flow 

Result 

overflow 

Overflow 



zero; no overflow 

less than zero; no over- 



greater than zero; no 



Program Exceptions : 

Access (fetch, operand 2 of S only) 
Fixed-point overflow 
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Programmi ng Notes 



SL 



R 1 ,D a (X a ,B a ) 



[RX] 



1. When, in the RR format, R, and R a 
designate the same register, 
subtracting is equivalent to clear- 
ing the register. 



Subtracti ng 
number from 
tive number 
no overflow. 



a maximum negative 

another maximum nega- 

gives a zero result and 



SUBTRACT HALFWORD 



l 5F t 


R» 


x a 


B 2 


D a 



8 



12 



16 



20 



31 



The second operand is subtracted from 
the first operand, and the difference is 
placed at the first-operand location. 
The operands and the difference are 
treated as 32-bit unsigned binary inte- 
gers. 

Resulti ng Condi t i on Code : 



SH 



R,,D a (X a ,B a ) 



[RX3 



f 4B* 


Rt 


X a 


B a 


D a 



8 



12 



16 



20 



31 



The second operand is subtracted from 
the first operand, and the difference is 
placed at the first-operand location. 
The second operand is two bytes in 
length and is treated as a 16-bit signed 
binary integer. The first operand and 
the difference are treated as 32-bit 
signed binary integers. 

Ulhen there is an overflow, the result is 
obtained by allowing any carry into the 
sign-bit position and ignoring any carry 
out of the sign-bit position, and condi- 
tion code 3 is set. If the fixed- 
point-overflow mask is one, a program 
interruption for fixed-point overflow 
occurs. 

Resulti ng Condi ti on Code ? 

Result zero; no overflow 

1 Result less than zero; no over- 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Exceptions ? 

Access Cfetch, operand 2) 
Fixed-point overflow 



SUBTRACT LOGICAL 



1 Result not zero; no carry 

2 Result zero; carry 

3 Result not zero; carry 

Program Exceptions ? 

Access (fetch, operand 2 of SL 
only) 



Programming Notes 



1. 



2. 



Logical subtrac 
adding the one 1 
second operand 
to the first o 
the one's compl 
of one instead 
ment of the se 
in a carry when 
is zero. 



tion is perfo 
s complement 

and a value 
perand. The 
ement and th 
of the two's 
cond operand 
the second 



rmed by 

of the 

of one 

use of 

e value 

comple- 

results 

operand 



SUBTRACT LOGICAL differs from 
SUBTRACT only in the meaning of the 
condition code and in the absence 
of the interruption for overflow. 



A zero difference 
panied by a carry 
tion 0. 



is always accom- 
out of bit posi- 



The condition-code setting for 
SUBTRACT LOGICAL can also be inter- 
preted as indicating the presence 
and absence of a borrow, as 
follows? 

1 Result not zero; borrow 

2 Result zero; no borrow 

3 Result not zero; no borrow 



SLR R,,R. 



[RR3 



SUPERVISOR CALL 



t 1F l 


Ri 


R a 



8 12 15 



SVC 



[RR] 



»0A f 


I 



8 15 

The instruction causes a supervisor-call 
interruption, with the I field of the 
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instruction providing the rightmost byte 
of the interruption code. 

Bits 8-15 of the instruction* with eight 
zeros appended on the left> are placed 
in the supervisor-call interruption code 
that is stored in the course of the 
interruption. See "Supervisoi — Call In- 
terruption" in Chapter 6* 
"Interrupti ons." 

A serialization and checkpoint- 
synchronization function is performed. 

Condi t i on Code - The code remains 
unchanged and is saved as part of the 
old PSW. A new condition code is loaded 
as part of the supervisoi — call i ntei — 
rupt i on . 

Program Excepti ons ? None. 



2. 



storage area by programs operating 
on different CPUs. This instruc- 
tion is provided primarily for 
compatibility with programs written 
for System/360. The instructions 
COMPARE AND SWAP and COMPARE DOUBLE 
AND SWAP provide functions which 
are more suitable for sharing among 
programs on a single CPU or for 
programs that may be interrupted. 
See the description of these 
instructions and the associated 
programming notes for details. 

TEST AND SET does not interlock 
against storage accesses by channel 
programs. Therefore* the instruc- 
tion should not be used to update a 
location into which a channel 
program may store* since the 
channel-program data may be lost. 



TEST AND SET 



TEST UNDER MASK 



TS 



D 2 (B 2 ) 



[S3 



TM 



D,(B,),I 2 



CSI3 



'93' 


//////// 


B 9 


D 2 



8 



16 



20 



31 



The leftmost bit (bit position 0) of the 
byte located at the second-operand 
address is used to set the condition 
code* and then the byte is set to all 
ones. 



Bits 8-15 of 
i gnored. 



the instruction 



are 



The byte in storage is set to all ones 

as it is fetched for the testing of bit 

I position 0. This update appears to be 

I an i nterlocked-update reference as 

j observed by other CPUs. 

A serialization function is performed 
before the byte is fetched and again 
| after the storing of all ones. 

Result i ng Condi ti on Code: 



Leftmost bit zero 
Leftmost bit one 



Program Excepti ons ? 

Access (fetch and store* operand 2) 

Programmi ng Notes 



TEST AND SET may be used for 
controlled sharing of a common 



f 91 t 


I* 


B, 


D, 



8 



16 



20 



31 



A mask is used to select bits of the 
first operand* and the result is indi- 
cated in the condition code. 

The byte of immediate data* I 2 , is used 
as an eight-bit mask. The bits of the 
mask are made to correspond one for one 
with the bits of the byte in storage 
designated by the first-operand address. 

A mask bit of one indicates that the 
storage bit i s to be tested. When the 
mask bit is zero, the storage bit is 
ignored. When all storage bits thus 
selected are zero* condition code is 
set. Condition code is also set when 
the mask is all zeros. When the 
selected bits are all ones* condition 
code 3 is set* otherwise* condition code 
1 is set. 

Access exceptions associated with the 
storage operand are recognized for one 
byte even when the mask is all zeros. 



Result i ng Condi ti on Code ? 




Selected bits all zeros* 
mask bits all zeros 
Selected bits mixed zeros 
ones 



or 
and 



3 Selected bits all ones 
Program Exceptions ? 

Access (fetch* operand 1) 



i 
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Programme ng Note 



An example of the use of the TEST UNDER 
MASK instruction is given in Appendix A. 



TRANSLATE 



3. 



TR 



D,(L,B t ),D,(B 3 ) 



[SS] 



DC 



B, 



D, 
-/— 



8 



16 



20 



32 



/ 1 

D 2 

— / ' 

36 47 



The bytes of the first operand are used 
as eight-bit arguments to reference a 
list designated by the second-operand 
address. Each function byte selected 
from the list replaces the corresponding 
argument in the first operand. 

The L field specifies the length of only 
the first operand. 



The bytes of the 
selected one by on 
proceeding left to r 
byte i s added to 
operand address, 
performed followin 
address arithmetic, 
byte treated as an 
binary integer and 
on the left. The 
address of the funct 
replaces the origina 



first operand are 
e for translation, 
i ght . Each argument 
the initial second- 

The addi ti on is 
g the rules for 

with the argument 

eight-bit unsigned 
extended with zeros 
sum is used as the 
ion byte, which then 
1 argument byte. 



The operation proceeds until the first- 
operand field is exhausted. The list is 
not altered unless an overlap occurs. 

When the operands overlap, the result is 
obtained as if each result byte were 
stored immediately after fetching the 
corresponding function byte. 

Access exceptions are recognized only 
for those bytes in the second operand 
which are actually required. 

Condi ti on Code ? The code remains 
unchanged. 

Program Except i ons ? 

Access (fetch, operand 2; fetch and 
store, operand 1) 



The instruction may also be used to 
rearrange data. This may be accom- 
plished by placing a pattern in the 
destination area, by designating 
the pattern as the f i rst operand of 
TRANSLATE, and by designating the 
data that i s to be rearranged as 
the second operand. Each byte of 
the pattern contains an eight-bit 
number specifying the byte destined 
for this position. Thus, when the 
instruction is executed, the 
pattern selects the bytes of the 
second operand in the desired 
order. 

Because each eight-bit argument 
byte is added to the initial 
second-operand address to obtain 
the address of a function byte, the 
list may contain 256 bytes. In 
cases where it is known that not 
all eight-bit argument values will 
occur, it is possible to reduce the 
size of the list. 

Significant performance degradation 
is possible when, with DAT on, the 
second-operand address of TRANSLATE 
designates a location that is less 
than 256 bytes to the left of a 
4K-byte boundary. This is because 
the machine may perform a trial 
execution of the instruction to 
determine if the second operand 
actually crosses the boundary. 



The fetch and 
accesses to a pa 
the first-operand 
necessarily occur 
after the other 
instruction cannot 
to update a locati 
the possibility ex 
CPU or a channel 
be updating the lo 
pie of this effect 
COD in the secti 
ming and Multipro 
i n Appendix A. 



subsequent store 
rticular byte in 

field do not 

one immediately 

Thus, this 

be safely used 
on in storage if 
i sts that another 
program may also 
cation. An exam- 

i s shown for OR 
on "Multi program- 
cessing Examples" 



The storage-operand references of 
TRANSLATE may be multiple-access 
references. (See the section 
"Storage-Operand Consistency" in 
Chapter 5, "Program Execution.") 



TRANSLATE AND TEST 



Programmi nq Notes 



An example of the use of the TRANS- 
LATE instruction is given in Appen- 
dix A. 

TRANSLATE may be used to convert 
data from one code to another code. 



TRT 



D,(L,B,),D 3 (B 3 ) 



DD' 



B, 



8 



16 



D, 
-/— 



20 



CSS3 



-/ 1 

-/J 



32 



36 47 



The bytes of the first operand are used 
as eight-bit arguments to select func- 
tion bytes from a list designated by the 
second-operand address. The first 
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nonzero function byte is inserted in 
general register 2, and the related 
argument address in general register 1. 

The L field specifies the length of only 
the first operand. 

The bytes of the first operand are 
selected one by one for translation, 
proceeding from left to right. The 
first operand remains unchanged in stor- 
age. Calculation of the address of the 
function byte is performed as in the 
TRANSLATE instruction. The function 
byte retrieved from the list is 
inspected for a value of zero. 

When the function byte is zero, the 
operation proceeds with the next byte of 
the first operand. When the first- 
operand field is exhausted before a 
nonzero function byte is encountered, 
the operation is completed by setting 
condition code 0. The contents of 
general registers 1 and 2 remain 
unchanged. 

When the function byte is nonzero, the 
operation is completed by inserting the 
function byte in general register 2 and 
the related argument address in general 
register 1. This address points to the 
argument byte last translated. The 
function byte replaces bits 24-31 of 
general register 2. In the 24-bit 
addressing mode, the address replaces 
bits 8-31, and bits 0-7 of general 
register 1 remain unchanged. In the 
31-bit addressing mode, the address 
replaces bits 1-31, and bit of general 
register 1 is set to zero. In both 
modes, bits 0-23 of general register 2 
remain unchanged. 

When the function byte is nonzero, 
either condition code 1 or 2 is set, 
depending on whether the argument byte 
is the rightmost byte of the first opei — 
and. Condition code 1 is set if one or 
more argument bytes remain to be trans- 
lated. Condition code 2 is set if no 
more argument bytes remain. 

Access exceptions are recognized only 
for those bytes in the second operand 
which are actually required. Access 
exceptions are not recognized for those 
bytes in the first operand which are to 
the right of the first byte for which a 
nonzero function byte is obtained. 

Result i nq Condi ti on Codes 



All function bytes zero 
Nonzero function byte; first- 
operand field not exhausted 
Nonzero function byte; first- 
operand field exhausted 



Programmi ng Notes 



An example of the use of the TRANS- 
LATE AND TEST instruction is given 
in Appendix A. 

TRANSLATE AND TEST may be used to 
scan the first operand for charac- 
ters with special meaning. The 
second operand, or list, is set up 
with all-zero function bytes for 
those characters to be skipped over 
and with nonzero function bytes for 
the characters to be detected. 



UNPACK 



UNPK 



D,(L t ,B, ),D 2 (L 2 ,B 2 ) 



CSS] 



F3 



L, 



B, 



D, 
-/— 



-/——-i 

./ „ i 



Program Exceptions ? 

Access (fetch, operands 1 and 2) 



8 12 16 20 32 36 47 

The format of the second operand is 
changed from packed to zoned, and the 
result is placed at the first-operand 
location. The packed and zoned formats 
are described in Chapter 8, "Decimal 
Instructi ons." 

The second operand is treated as though 
it had the packed format. Its digits 
and sign are placed unchanged in the 
first-operand location, using the zoned 
format. Zone bits with coding of 1111 
are supplied for all bytes except the 
rightmost byte, the zone of which 
receives the sign of the second operand. 
The sign and digits are not checked for 
valid codes. 

The result is obtained as if the opei — 
ands were processed right to left. When 
necessary, the second operand is consid- 
ered to be extended on the left with 
zeros. If the first-operand field is 
too short to contain all digits of the 
second operand, the remaining leftmost 
portion of the second operand is 
ignored. Access exceptions for the 
unused portion of the second operand may 
or may not be indicated. 

When the operands overlap, the result is 
obtained as if the operands were proc- 
essed one byte at a time and as if the 
first result byte were stored immediate- 
ly after fetching the first operand 
byte. The entire rightmost second- 
operand byte is used in forming the 
first result byte. For the remainder of 
the field, information for two result 
bytes is obtained from a single second- 
operand byte, and execution proceeds as 
if the leftmost four bits of the byte 
were to remain available for the next 
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) 



result byte and need not be ref etched. 
Thus, the result is as if two result 
bytes Mere to be stored immediately 
after fetching a single operand byte. 



Condi ti on Code ; The code 
unchanged. 

Program Excepti ons » 

Access (fetch, operand 2; 
operand 1) 



Programming Notes 



remains 



store, 



An example of the use of the UNPACK 
instruction is given in Appendix A. 



A field that is to be 
be destroyed by impro 
ping. To save stora 
unpacking by overlappi 
ands, the rightmost 
first operand must be 
of the rightmost byte 
operand by the number 
the second operand m 
only one or two byte 
unpacked, the rightmo 
the two operands may c 



unpacked can 
per overlap- 
ge space for 
ng the opei — 
byte of the 

to the right 
of the second 

of bytes in 
inus 2. If 
s are to be 
st bytes of 
oi nci de. 



The storage-operand references of 
UNPACK may be multiple-access 
references. (See the section 
"Storage-Operand Consistency" in 
Chapter 5, "Program Execution.") 



UPDATE TREE 



UPT 



[E] 



'0102' 



15 

The doubleword nodes of a tree in stor- 
age are examined successively on a path 
toward the base of the tree, and the 
contents of general-register pair 0-1 
are conditionally interchanged with the 
contents of the nodes so as to give a 
unique maximum logical value in general 
register 0. 

General register 4 contains the base 
address of the tree, and general regis- 
ter 5 contains the index of a node whose 
parent node will be examined first. The 
initial contents of general registers 4 
and 5 must be a multiple of 8; 
otherwise, a specification exception is 
recognized. 

This instruction may be interrupted 
between units of operation. A unit of 
operation begins by shifting the 
contents of general register 5 right 



logi cal 
bit 29 
remai ns 
uni t o 
suppres 
setti ng 
regi ste 
complet 
Otherwi 
ues i n 
methods 
unpredi 



ly one pos 

to zero. 

unchanged 

f operat 

sed. If 

bit 29 to 
r 5 are ze 
ed, and co 
se, the un 
accordan 
, and whi 
ctable. 



ition and then 

However, reg 

if the execut 

ion is nulli 

after shifti 

zero, the con 

ro, the instru 

ndition code 1 

it of operation 

ce with one 

ch method i s 



setti ng 
i ster 5 
ion of a 
fied or 
ng and 
tents of 
cti on is 

is set. 

conti n- 

of two 
used is 



UPDATE TREE Method 1 



When the first method of operation is 
used, the sum of the contents of general 
registers 4 and 5 is used as the intei — 
mediate value for normal operand address 
generation. The generated address is 
the address of a node in storage. 

The contents of general register are 
logically compared with the contents of 
the first word of the currently 
addressed node. If the register operand 
is low, the contents of general-register 
pair 0-1 are interchanged with those of 
the node, and a unit of operation is 
completed. If the register operand is 
high, no additional action is taken, and 
the unit of operation is completed. If 
the compare values are equal, general- 
register pair 2-3 is loaded from the 
currently addressed node, the instruc- 
tion is completed, and condition code 
is set. 

In those cases when the value in the 
first word of the node is less than or 
equal to the value in the register, the 
contents of the node remain unchanged. 
However, in some models, these contents 
may be fetched and subsequently stored 
back. 

Access exceptions are recognized only 
for one doubleword node at a time. 
Access exceptions, change-bit action, 
and PER storage alteration do not occur 
for subsequent nodes until the previous 
node has been successfully compared and 
updated. 

Access exceptions, change-bit action, 
and PER storage alteration do not occur 
if a specification exception exists. 



UPDATE TREE Method 2 



When the second method of operation is 
used, bit of general register is 
tested. If bit of register is one, 
the instruction is completed, and condi- 
tion code 3 is set. If bit is zero, 
the remainder of the unit of operation 
is the same as when method 1 is used. 
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Resulting Condition Code : 

1 



Equal compare values at 
currently addressed node 

No equal compare values found 

on path* or no comparison made 



For method 2 only: general 
register 5 nonzero and general 
register negative 



Program Exceptions : 

Access (fetch and store* nodes of 

tree) 
Speci f i cati on 



Programming Notes 



For use in sorting* when equal 
compare values have been found* the 
contents of general regi sters 1 and 
3 can be appropriate (depending on 
the contents of the tree) for the 
subsequent execution of COMPARE AND 
FORM CODEWORD. The contents of 
general register 2* shifted right 
16 bit positions* can be similarly 
appropriate* and they can provide 
for minimal recompari son of 
partially equal keys. 

The program should avoid placing a 
nonzero value in bit positions 0-6 
of general register 5 when in the 
24-bit addressing mode. If any bit 
in bit positions 0-6 is a one, the 



nodes of the tree will not be exam- 
ined successively. 

3. The storage-operand references for 
UPDATE TREE may be multiple-access 
references. (See the section 
"Storage-Operand Consistency" in 
Chapter 5* "Program Execution.") 

4. In those cases when the value in 
the first word of the node is less 
than or equal to the value in the 
register* depending on the model* 
the contents of the node may be 
fetched and subsequently stored 
back. As a result* any of the 
following may occur for the storage 
location containing the node: a 
PER storage-alteration event may be 
recognized* a protection exception 
for storing may be recognized* and* 
provided no access exceptions 
exist* the change bit may be set to 
one. 

5. Special precautions should be taken 
when UPDATE TREE is made the target 
of EXECUTE. See the programming 
note concerning i nterrupti ble 
instructions under EXECUTE. 

6. Further programming notes concern- 
ing interruptible instructions are 
included in the section "Interrup- 
tible Instructions" in Chapter 5* 
"Program Execution." 

7. The figure "Execution of UPDATE 
TREE" is a summary of the operation 
of UPDATE TREE. 
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Bits 29-31 of GR4 and GR5 all zeros 



Unit-of- 
operati on 
boundary 



No 



-» Specification Exception 



Yes 



GR5 shifted right one position * TEMPW0RD1 

* Bit 29 of TEMPW0RD1 



* 


Yes 




TEMPW0RD1 = 










No 





— -» GR5 

1 » Cond Code 



Method used 



Method 2 



Method 1 


No 


* 




Bit of GRO one 







GR4 + TEMPW0RD1 » TEMPADDRESS 



Fetch doubleword from location in 
storage designated by TEMPADDRESS; 

Bits 0-31 » TEMPW0RD2 

Bits 32-64 — •» TEMPW0RD3 



TEMPW0RD1 ► GR5 



GRO high 



Compare GRO and TEMPW0RD2 



GRO equal 



GRO low 



Store contents of GRO and GR1 in 
doubleword designated by TEMPADDRESS 



TEMPW0RD2 — ■* GRO 
TEMPW0RD3 » GR1 



Execution of UPDATE TREE 



Yes 



TEMPW0RD1 » GR5 

3 » Cond Code 



End operation 



TEMPW0RD2 — ■* GR2 

TEMPW0RD3 » GR3 

» Cond Code 



End operation 
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CHAPTER 8. DECIMAL INSTRUCTIONS 



Decimal-Number Formats 8-1 

Zoned Format 8-1 

Packed Format 8-1 

Decimal Codes 8-2 

Decimal Operations 8-2 

Decimal-Arithmetic Instructions 8-2 

Editing Instructions 8-3 

Execution of Decimal Instructions 8-3 

Other Instructions for Decimal Operands 8-3 

Instruct i ons 8-3 

ADD DECIMAL 8-5 

COMPARE DECIMAL 8-5 

DIVIDE DECIMAL 8-5 

EDIT 8-6 

EDIT AND MARK 8-9 

MULTIPLY DECIMAL 8-10 

SHIFT AND ROUND DECIMAL 8-10 

SUBTRACT DECIMAL 8-11 

ZERO AND ADD 8-12 
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DECIMAL-NUMBER FORMATS 



Decimal numbers may be represented in 
either the zoned or packed format. Both 
decimal-number formats are of variable 
length; the instructions used to operate 
on decimal data each specify the length 
of their operands and results. Each 
byte of either format consists of a pair 
of foui — bit codes; the foui — bit codes 
include decimal-digit codes? sign codes, 
and a zone code. 



bits may be treated either 
as a si gn (S) . 



as a zone or 



Decimal digits in the zoned format may 
be part of a larger character set, which 
includes also alphabetic and special 
characters. The zoned format is, there- 
fore, suitable for input, editing, and 
output of numeric data in human-readable 
form. There are no decimal-arithmetic 
instructions which operate directly on 
decimal numbers in the zoned format; 
such numbers must first be converted to 
the packed format. 

The editing instructions produce a 
result of up to 256 bytes; each byte may 
be a decimal digit in the zoned format, 
a message byte, or a fill byte. 



PACKED FORMAT 



) 



ZONED FORMAT 



Z/S 



In the zoned format, the rightmost four 
bits of a byte are called the numeric 
bits (N) and normally consist of a code 
representing a decimal digit. The left- 
most four bits of a byte are called the 
zone bits (Z), except for the rightmost 
byte of a decimal operand, where these 



In the packed format, each byte contains 
two decimal digits (D), except for the 
rightmost byte, which contains a sign to 
the right of a decimal digit. Decimal 
arithmetic is performed with operands in 
the packed format and generates results 
in the packed format. 

The packed-format operands and results 
of decimal-arithmetic instructions may 
be up to 16 bytes (31 digits and sign), 
except that the maximum length of a 
multiplier or divisor is eight bytes (15 
digits and sign). In division, the sum 
of the lengths of the quotient and 
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remainder may be from two to 16 bytes. 
The editing instructions can fetch as 
many as 256 decimal digits from one or 
more decimal numbers of variable length, 
each in the packed format. 



DECIMAL CODES 



The decimal digits 0-9 have 
encoding 0000-1001. 



the binary 



The preferred sign codes are 1100 for 
plus and 1101 for minus. These are the 
sign codes generated for the results of 
the decimal-arithmetic instructions and 
the CONVERT TO DECIMAL instruction. 

Alternate sign codes are also recognized 
as valid in the sign position: 1010, 
1110, and 1111 are alternate codes for 
plus, and 1011 is an alternate code for 
minus. Alternate sign codes are 
accepted for any decimal source operand, 
but are not generated in the completed 
result of a decimal-arithmetic instruc- 
tion or CONVERT TO DECIMAL. This is 
true even when an operand remains other- 
wise unchanged, such as when adding zero 
to a number. An alternate sign code is, 
however, left unchanged by MOVE 
NUMERICS, MOVE WITH OFFSET, MOVE ZONES, 
PACK, and UNPACK. 

When an invalid sign or digit code is 
detected, a data exception is 
recognized. For the decimal-arithmetic 
instructions and CONVERT TO BINARY, the 
action taken for a data exception 
depends on whether a sign code is inval- 
id. When a sign code is invalid, the 
operation is suppressed regardless of 
whether any other condition causing a 
data exception exists. When an invalid 
digit code is detected but no sign code 
is invalid, the operation is terminated. 

For the editing instructions EDIT and 
EDIT AND MARK, an invalid sign code is 
not recognized. The operation is termi- 
nated for a data exception due to an 
invalid digit code. No validity check- 
ing i s performed by MOVE NUMERICS, MOVE 
WITH OFFSET, MOVE ZONES, PACK, and 
UNPACK. 

The zone code 1111 is generated in the 
left four bit positions of each byte 
representing a zone and a decimal digit 
in zoned-format results. Zoned-format 
results are produced by EDIT, EDIT AND 
MARK, and UNPACK. For EDIT and EDIT AND 
MARK, each result byte representing a 
zoned-format decimal digit contains the 
zone code 1111 in the left four bit 
positions and the decimal-digit code in 

bit positions. For 

wi th 

all 
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a coding of 1111 
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The meaning of the decimal codes is 
summarized in the figure "Summary of 
Digit and Sign Codes." 



Programmi ng Note 



Since 1111 is both the zone code and an 
alternate code for plus, unsigned (posi- 
tive) decimal numbers may be represented 
in the zoned format with 1111 zone codes 
in all byte positions. The result of 
the PACK instruction converting such a 
number to the packed format may be used 
directly as an operand for decimal 
i nstruct i ons. 



Code 


Recognized As 


Digit 


Si gn 


0000 





Inval i d 


0001 


1 


Invali d 


0010 


2 


Invali d 


0011 


3 


Invali d 


0100 


4 


Inval i d 


0101 


5 


Invali d 


0110 


6 


Invali d 


0111 


7 


Inval i d 


1000 


8 


Invali d 


1001 


9 


Inval i d 


1010 


Invali d 


Plus 


1011 


Inval i d 


Mi nus 


1100 


Inval i d 


Plus (preferred) 


1101 


Inval id 


Minus (preferred) 


1110 


Invali d 


Plus 


1111 


Invali d 


Plus (zone) 



Summary of Digit and Sign Codes 



DECIMAL OPERATIONS 



The decimal instructions in this chapter 
consist of two classes, the decimal- 
arithmetic instructions and the editing 
i nstructi ons. 



DECIMAL-ARITHMETIC INSTRUCTIONS 



The decimal-arithmetic instructions 
perform addition, subtraction, multipli- 
cation, division, comparison, and shift- 
i ng. 

Operands of the decimal-arithmetic 
instructions are in the packed format 
and are treated as signed decimal inte- 
gers. A decimal integer is represented 
in true form as an absolute value with a 
separate plus or minus sign. It 
contains an odd number of decimal 
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digits, from one to 31, and the sign; 
this corresponds to an operand length of 
one to 16 bytes. 

A decimal zero normally has a plus sign, 
but multiplication, division, and ovei — 
flow may produce a zero value with a 
minus sign. Such a negative zero is a 
valid operand and is treated as equal to 
a positive zero by COMPARE DECIMAL. 

The lengths of the two operands speci- 
fied in the instruction need not be the 
same. If necessary, the shorter operand 
is considered to be extended with zeros 
on the left. Results, however, cannot 
exceed the first-operand length as spec- 
ified in the instruction. 

When a carry or leftmost nonzero digits 
of the result are lost because the 
first-operand field is too short, the 
result is obtained by ignoring the ovei — 
flow digits, condition code 3 is set, 
and, if the decimal-overflow mask bit is 
one, a program interruption for decimal 
overflow occurs. The operand lengths 
alone are not an indication of overflow; 
nonzero digits must have been lost 
during the operation. 

The operands of decimal-arithmetic 
instructions should not overlap at all 
or should have coincident rightmost 
bytes. In ZERO AND ADD, the operands 
may also overlap in such a manner that 
the rightmost byte of the first operand 
(which becomes the result) is to the 
right of the rightmost byte of the 
second operand. For these cases of 
proper overlap, the result is obtained 
as if operands were processed right to 
left. Because the codes for digits and 
signs are verified during the perform- 
ance of the arithmetic, improperly 



are recognized as 



overlapping operands 
data exceptions. 



Programmi ng Note 



A packed decimal number in storage may 
be designated as both the first and 
second operand of ADD DECIMAL, COMPARE 
DECIMAL, DIVIDE DECIMAL, MULTIPLY DECI- 
MAL, SUBTRACT DECIMAL, or ZERO AND ADD. 
Thus, a decimal number may be added to 
itself, compared with itself, and so 
forth; SUBTRACT DECIMAL may be used to 
set a decimal field in storage to zero, 
and, for MULTIPLY DECIMAL, a decimal 
number may be squared in place. 



second operand (the source) is consid- 
ered to have as many digits as necessary 
for the completion of the operation. 

Overlapping operands for the editing 
instructions yield unpredictable re- 
sults. 



EXECUTION OF DECIMAL INSTRUCTIONS 



During the execution of a decimal 
instruction, all bytes of the operands 
&r& not necessarily accessed concurrent- 
ly, and the fetch and store accesses to 
a single location do not necessarily 
occur one immediately after the other. 
Furthermore, for decimal instructions, 
data in source fields may be accessed 
more than once, and intermediate values 
may be placed in the result field that 
may differ from the original operand and 
final result values. (See the section 
"Storage-Operand Consistency" in Chapter 
5, "Program Execution.") Thus, in a 
multiprocessing configuration, an 
instruction such as ADD DECIMAL cannot 

update a shared stoi — 
the possibility exists 
may also be updating 



be safely used to 
age location when 
that another CPU 
that location. 



OTHER INSTRUCTIONS FOR DECIMAL OPERANDS 



In addition to the decimal instructions 
in this chapter, MOVE NUMERICS and MOVE 
ZONES are provided for operating on data 
of lengths up to 256 bytes in the zoned 
format. Two instructions are provided 
for converting data between the zoned 
and packed formats: PACK transforms 
zoned data of lengths up to 16 bytes 
into packed data, and UNPACK performs 
the reverse transformation. MOVE WITH 
OFFSET can operate on packed data of 
lengths up to 16 bytes. Two 
instructions are provided for conversion 
between the packed-decimal and signed- 
binary-integer formats. CONVERT TO 
BINARY converts packed decimal to 
binary, and CONVERT TO DECIMAL converts 
binary to packed decimal; the length of 
the packed decimal operand of these 
instructions is eight bytes (15 digits 
and sign). These seven instructions are 
not considered to be decimal 
instructions and are described in Chap- 
ter 7, "General Instructions." The 
editing instructions in this chapter may 
also be used to change data from the 
packed to the zoned format. 



EDITING INSTRUCTIONS 



) 



The editing instructions are EDIT and 
EDIT AND MARK. For these instructions, 
only the first operand (the pattern) has 
an explicitly specified length. The 



INSTRUCTIONS 



The decimal instructions and their 
mnemonics, formats, and operation codes 
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are listed in the figure "Summary of 
Decimal Instructions." The figure also 
indicates when the condition code is set 
and the exceptional conditions in opei — 
and designations, data, or results that 
cause a program interruption. 

Note ? In the detailed descriptions of 
the individual instructions, the mnemon- 
ic and the symbolic operand designation 
for the assembler language are shown 
with each instruction. For ADD DECIMAL, 
for example, AP is the mnemonic and 
D t (L tJi )»D 2 (L 2 ,B 2 ) the operand desig- 
nat i on . 



Programming Note 



The decimal instructions for the 370-XA 
mode and the System/370 mode are identi- 
cal, with the exception that, in the 
31-bit addressing mode, EDIT AND MARK 
places a 31-bit address in general 
register 1. In the 24-bit addressing 
mode, EDIT AND MARK operates as in the 
System/370 mode; that is, a 24-bit 
address is placed in general register 1, 
and the leftmost byte of general regis- 
ter 1 is unchanged. 





Mne- 














Op 


Name 


moni c 






Cha 


racteri sties 




Code 


ADD DECIMAL 


AP 


SS 


C 


A 




D 


DF 


ST 


FA 


COMPARE DECIMAL 


CP 


SS 


C 


A 




D 






F9 


DIVIDE DECIMAL 


DP 


SS 




A 


SP 


D 


DK 


ST 


FD 


EDIT 


ED 


SS 


C 


A 




D 




ST 


DE 


EDIT AND MARK 


EDMK 


SS 


C 


A 




D 


Gl 


R ST 


DF 


MULTIPLY DECIMAL 


MP 


SS 




A 


SP 


D 




ST 


FC 


SHIFT AND ROUND DECIMAL 


SRP 


SS 


C 


A 




D 


DF 


ST 


FO 


SUBTRACT DECIMAL 


SP 


SS 


C 


A 




D 


DF 


ST 


FB 


ZERO AND ADD 


ZAP 


SS 


C 


A 




D 


DF 


ST 


F8 


Explanati on: 


jical addresses 










A Access exceptions for loj 


C Condition code is set. 












D Data exception. 












DF Decimal-overflow excepticn. 












DK Decimal-divide exception. 












Gl Instruction execution includes the 


impl 


ied use of 


general register 1. 


R PER general-register-alteration event. 










SP Specification exception. 












SS SS instruction format. 












ST PER storage-alteration event. 













Summary of Decimal Instructions 
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ADD DECIMAL 



COMPARE DECIMAL 



AP 



D,(Li ,B t ),D 2 (L 2 ,B 2 ) 



[SS] 



CP 



D t (Lt ,Bi ),D 2 (L 2 ,B 2 ) 



[SS] 



FA 



L, 



L 2 



B, 



D, 
-/— 



3 



8 



12 



16 



20 



32 36 47 



The second operand is added to the first 
operand, and the resulting sum is placed 
at the first-operand location. The 
operands and result are in the packed 
format . 

Addition is algebraic, taking into 
account the signs and all digits of both 
operands. All sign and digit codes are 
checked for validity. 

If the first operand is too short to 
contain all leftmost nonzero digits of 
the sum, decimal overflow occurs. The 
operation is completed. The result is 
obtained by ignoring the overflow 
digits, and condition code 3 is set. If 
the decimal-overflow mask is one, a 
program interruption for decimal ovei — 
flow occurs. 

The sign of the sum is determined by the 
rules of algebra. In the absence of 
overflow, the sign of a zero result is 
made positive. If overflow occurs, a 
zero result is given either a positive 
or negative sign, as determined by what 
the sign of the correct sum would have 
been. 

Resulting Condi tion Code : 

Result zero; no overflow 

1 Result less than zero; no over- 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Excepti ons ? 

Access (fetch, operand 2; fetch and 

store, operand 1) 
Data 
Decimal overflow 



Programmi ng Note 



F9 



L, 



B, 



Dt 
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3 



8 



12 16 



20 



32 



36 47 



The first operand is compared with the 
second operand, and the result is indi- 
cated in the condition code. The oper- 
ands are in the packed format. 

Comparison is algebraic and follows the 
procedure for decimal subtraction, 
except that both operands remain 
unchanged. When the difference is zero, 
the operands are equal. When a nonzero 
difference is positive or negative, the 
first operand is high or low, respec- 
ti vely . 



Overflow cannot occur 
difference is discarded. 



because the 



All sign and digit codes are checked for 
vali di ty . 

Resulti ng Condi ti on Code : 

Operands equal 

1 First operand low 

2 First operand high 
3 

Program Excepti ons : 

Access (fetch, operands 1 and 2) 
Data 



Programming Notes 



1. An example of the use of the 
COMPARE DECIMAL instruction is 
given in Appendix A. 

2. The preferred and alternate sign 
codes for a particular sign are 
treated as equivalent for compai — 
i son purposes. 

3. A negative zero and a positive zero 
compare equal. 



An example of the use of the ADD DECIMAL 
instruction is given in Appendix A. 



DIVIDE DECIMAL 



DP 



D t (Lt ,B, ),D 2 (L 2 >B 2 ) 



FD' 



L, 



Bt 



D, 
-/— 



CSS] 



B 2 | d7] 



8 12 16 20 32 36 47 

The first operand (the dividend) is 
divided by the second operand (the divi- 
sor). The resulting quotient and 
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remainder are placed at the first- 
operand location. The operands and 
results are in the packed format. 



The quotient is placed 
first-operand location, 
bytes in the quotient 
the difference between 
divisor lengths (Li - L 
der is placed rightmos 
operand location and ha 
to the divisor length 
quotient and remainder 
entire first operand; 
address of the quotien 
of the first operand. 



leftmost in the 

The number of 

field is equal to 

the dividend and 

2 ). The remain- 

t in the first- 

s a length equal 

Together, the 

fields occupy the 

therefore* the 

t is the address 



The divisor length cannot exceed 15 
digits and sign (L a not greater than 
seven) and must be less than the divi- 
dend length (L 2 less than L t ) ; 
otherwise* a specification exception is 
recogni zed. 

The dividend, divisor, quotient, and 
remainder are each signed decimal inte- 
gers in the packed format and are 
right-aligned in their fields. All sign 
and digit codes of the dividend and 
divisor are checked for validity. 

The sign of the quotient is determined 
by the rules of algebra from the divi- 
dend and divisor signs. The sign of the 
remainder has the same value as the 
dividend sign. These rules hold even 
when the quotient or remainder is zero. 



Overflow cannot occu 
is zero or the quotie 
be represented by th 
specified, a decimal- 
recognized. This in 
division of zero by 
divide exception is 
the sign codes of bo 
divisor are valid, an 
or digits used in 
exception are valid. 



r. If the divisor 
nt is too large to 
e number of digits 
divide exception is 
eludes the case of 
zero. The decimal- 
indicated only if 
th the dividend and 
d only if the digit 
establishing the 



Condi ti on 
unchanged, 



Code: 



The code 



remai ns 



Program Excepti ons : 

Access (fetch, operand 2; fetch and 

store, operand 1) 
Data 

Decimal divide 
Speci f i cati on 



Programming Notes 



An example of the use of the DIVIDE 
DECIMAL instruction is given in 
Appendix A. 



The dividend 
digits and sign, 
der cannot be 



cannot exceed 31 
Since the remain- 
shorter than one 



digit and sign, the quotient cannot 
exceed 29 digits and sign. 

The condition for a decimal-divide 
exception can be determined by a 
trial comparison. The leftmost 
digit of the divisor is aligned one 
digit to the right of the leftmost 
dividend digit. When the divisor, 
so aligned, is less than or equal 
to the dividend, ignoring signs, a 
divide exception is indicated. 

If a data exception does not exist, 
a decimal-divide exception occurs 
when the leftmost dividend digit is 
not zero. 



EDIT 



ED 



D,(L,B, ),D 2 (B 2 ) 



[SS] 



DE' 



B, 



D, 
-/— 



-/ 1 

.5J 



8 



16 



20 



32 



36 47 



The second operand (the source), which 
normally contains one or more decimal 
numbers in the packed format, is changed 
to the zoned format and modified under 
the control of the first operand (the 
pattern). The edited result replaces 
the first operand. 

The length field specifies the length of 
the first operand, which may contain 
bytes of any value. 



length of the source 
the operation accord 
of the pattern, 
consists of one or 
each in the packed 



The 

by 

contents 

normally 

numbers, 

leftmost four 

must specify 

(0000-1001); a 

recognized as 

rightmost four 

sign code or 

Access and data exception 

nized only for those bytes 

operand which are actually 



bits of each 
a decimal 

sign code ( 
a data exc 

bits may spe 
a decimal 



is determined 
ing to the 

The source 
more decimal 
format. The 

source byte 
-digit code 
1010-1111) is 
eption. The 
cify either a 
-digit code, 
s are recog- 
in the second 
requi red. 



The result is obtained as if both opei — 
ands were processed left to right one 
byte at a time. Overlapping pattern and 
source fields give unpredictable 
results. 

During the editing process, each byte of 
the pattern is affected in one of three 
ways: 

1. It is left unchanged. 

2. It is replaced by a source digit 
expanded to the zoned format. 

3. It is replaced by the first byte in 
the pattern, called the fill byte. 



4 

Hi 
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Which of the three actions 
is determined by one or 
following: the type of 
byte^ the state of the 
indicator, and whether the 
examined is zero. 



takes place 
more of the 
the pattern 
si gni f i cance 
source digit 



Pattern Bytes : There are four types of 
pattern bytes: digit selector, signif- 
icance starter, field separator, and 
message byte. Their coding is as 
follows: 



Name 


Code 


Digit selector 
Significance starter 
Field separator 
Message byte 


0010 0000 
0010 0001 
0010 0010 
Any other 



The detection of eithe 
or a significance star 
causes an examination 
significance indicator 
digit. As a result, e 
source digit or the fi 
priate, is selected 
pattern byte. Additi 
ing a digit selector 
starter may cause the 
cator to be changed. 



r a digit selector 
ter in the pattern 
to be made of the 

and of a source 
ither the expanded 
11 byte, as appro- 

to replace the 
onally, encountei — 
or a significance 
significance indi- 



The field separator identifies individ- 
ual fields in a multiple-field editing 
operation. It is always replaced in the 
result by the fill byte, and the signif- 
icance indicator is always off after the 
field separator is encountered. 

Message bytes in the pattern are either 
replaced by the fill byte or remain 
unchanged in the result, depending on 
the state of the significance indicator. 
They may thus be used for padding, punc- 
tuation, or text in the significant 
portion of a field or for the insertion 
of sign-dependent symbols. 

Fi 11 Byte : The first byte of the 
pattern is used as the fill byte. The 
fill byte can have any code and may 
concurrently specify a control function. 
If this byte is a digit selector or 
significance starter, the indicated 
editing action is taken after the code 
has been assigned to the fill byte. 

Source Pi gi ts : Each time a digit selec- 
tor or significance starter is encount- 
ered in the pattern, a new source digit 
is examined for placement in the pattern 
field. Either the source digit is 
disregarded, or it is expanded to the 
zoned format, by appending the zone code 
1111 on the left, and stored in place of 
the pattern byte. 

Execution is as if the source digits 
were selected one byte at a time and as 
if a source byte were fetched for 
inspection only once during an editing 
operation. Each source digit is exam- 



ined only once for a zero value. The 
leftmost four bits of each byte are 
examined first, and the rightmost four 
bits, when they represent a decimal- 
digit code, remain available for the 
next pattern byte that calls for a digit 
examination. When the leftmost four 
bits contain an invalid digit code, a 
data exception is recognized, and the 
operation is terminated. 

At the time the left digit of a source 
byte is examined, the rightmost four 
bits are checked for the existence of a 
sign code. When a sign code is encount- 
ered in the rightmost four bit 
positions, these bits are not treated as 
a decimal-digit code, and a new source 
byte i s fetched from storage when the 
next pattern byte calls for a source- 
digit examination. 

When the pattern contains no digit 
selector or significance starter, no 
source bytes are fetched and examined. 



Si qnif i cance 
cance indicator 



Indi cator 



The 



i s turned on or 
indicate the significance or non 
i cance, respectively, of sub 
source digits or message bytes, 
i cant source digits replace their 
sponding digit selectors or signi 
starters in the result. Sign 
message bytes remain unchanged 
result. 



i gni f i - 
off to 
signi f - 
sequent 
Si gni f- 
corre- 
f i cance 
i f i cant 
i n the 



The significance indicator, by its on or 
off state, indicates also the negative 
or positive value, respectively, of a 
completed source field and is used as 
one factor in the setting of the condi- 
tion code. 

The significance indicator is set to off 
at the start of the editing operation, 
after a field separator is encountered, 
or after a source byte is examined that 
has a plus code in the rightmost four 
bit positions. 

The significance indicator is set to on 
when a significance starter is encount- 
ered whose source digit is a valid deci- 
mal digit, or when a digit selector is 
encountered whose source digit is a 
nonzero decimal digit, provided that in 
both instances the source byte does not 
have a plus code in the rightmost four 
bit positions. 

In all other situations, the signif- 
icance indicator is not changed. A 
minus sign code has no effect on the 
significance indicator. 

Result Bytes : The result of an editing 
operation replaces and is equal in 
length to the pattern. It is composed 
of pattern bytes, fill bytes, and zoned 
source digits. 

If the pattern byte is a message byte 
and the significance indicator is on, 
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the message byte remains unchanged in 
the result. If the pattern byte is a 
field separator or if the significance 
indicator is off when a message byte is 
encountered in the pattern> the fill 
byte replaces the pattern byte in the 
result . 



Program Exceptions : 

Access (fetch, operand 2; fetch and 

storey operand 1) 
Data 



If the digit selector or significance 
starter is encountered in the pattern 
with the significance indicator off and 
the source digit zero, the source digit 
is considered nonsi gni f i cant , and the 
fill byte replaces the pattern byte. If 
the digit selector or significance star- 
ter is encountered with either the 
significance indicator on or with a 
nonzero decimal source digit, the source 
digit is considered significant, is 
changed to the zoned format, and 
replaces the pattern byte in the result. 

Condi ti on Code: The sign and magnitude 
of the last field edited are used to set 
the condition code. The term "last 
field" refers to those source digits, if 
any, in the second operand selected by 
digit selectors or significance starters 
after the last field separator; if the 
pattern contains no field separator, 
there is only one field, which is 
considered to be the last field. If no 
such source digits are selected, the 
last field is considered to be of zero 
length. 

Condition code is set when the last 
field edited is zero or of zero length. 

Condition code 1 is set when the last 
field edited is nonzero and the signif- 
icance indicator is on. (This indicates 
a result less than zero if the last 



source byte examined contained a 
code in the rightmost four bits.) 



si gn 



Condition code 2 is set when the last 
field edited is nonzero and the signif- 
icance indicator is off. (This indi- 
cates a result greater than zero if the 
last source byte examined contained a 
sign code in the rightmost four bits.) 

The figure "Summary of Editing 
Functions" summarizes the functions of 
the EDIT and EDIT AND MARK operations. 
The leftmost four columns list all the 
significant combinations of the four 
conditions that can be encountered in 
the execution of an editing operation. 
The rightmost two columns list the 
action taken for each case — the type 
of byte placed in the result field and 
the new setting of the significance 
i ndi cator . 

Resulti ng Condi ti on Code: 



Last field zero or zero length 
Last field less than zero 
Last field greater than zero 



Programmi ng Notes 



1. Examples of the use of the EDIT in- 
struction are given in Appendix A. 

2. Editing includes sign and punctu- 
ation control, and the suppression 
and protection of leading zeros by 
replacing them with blanks or as- 
terisks. It also facilitates pro- 
grammed blanking of all-zero 
fields. Several fields may be 
edited in one operation, and numer- 
ic information may be combined with 
text. 

3. In most cases, the source is short- 
er than the pattern because each 
four-bit source digit produces an 
eight-bit byte in the result. 

4. The total number of digit selectors 
and significance starters in the 
pattern always equals the number of 
source digits edited. 

5. If the fill byte is a blank, if no 
significance starter exists in the 
pattern, and if the source digit 
examined for each digit selector is 
zero, the editing operation blanks 
the result field. 

6. The resulting condition code indi- 
cates whether or not the last field 
is all zeros and, if nonzero, 
reflects the state of the signif- 
icance indicator. The significance 
indicator reflects the sign of the 
source field only if the last 
source byte examined contains a 
sign code in the rightmost four 
bits. For multiple-field editing 
operations, the condition code 
reflects the sign and value only of 
the field following the last field 
separator. 

7. Significant performance degradation 
is possible when, with DAT on, the 
second-operand address of EDIT 
designates a location that is less 
than the length of the first oper- 
and to the left of a 4K-byte 
boundary. This is because the 
machine may perform a trial 
execution of the instruction to 
determine if the second operand 
actually crosses the boundary. The 
second operand of EDIT, while 
normally shorter than the first 
operand, can in the extreme case 
have the same length as the first. 



t 
\ 
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/ Conditions 




Results 














State of 












Previ ous 








Si gni f icance 




State of 




Right Four 




Indicator at 




Si gnif i cance 


Source 


Source Bits 




End of Digit 


Pattern Byte 


Indicator 


Digit 


Are Plus Code 


Result Byte 


Examinati on 


Digit selector 


Off 





X 


Fill byte 


Off 






1-9 


No 


Source digit** 


On 






1-9 


Yes 


Source digit** 


Off 




On 


0-9 


No 


Source digit 


On 






0-9 


Yes 


Source digit 


Off 


Significance starter 


Off 





No 


Fill byte 


On 









Yes 


Fill byte 


Off 






1-9 


No 


Source digit** 


On 






1-9 


Yes 


Source digit** 


Off 




On 


0-9 


No 


Source digit 


On 






0-9 


Yes 


Source digit 


Off 


Field separator 


X 


XX 


XX 


Fill byte 


Off 


Message byte 


Off 


XX 


XX 


Fill byte 


Off 




On 


XX 


XX 


Message byte 


On 


Explanation: 


asult byte or 


on new state of significance indicator. 


x No effect on r< 


xx Not applicable because sour* 


:e is not examined. 




** For EDIT AND MARK only, the 


address of the rightmost such result byte is 


placed in general register 


L. 





Summary of Editing Functions 



EDIT AND MARK 



) 



EDMK 



D,(L,B t ),D 2 (B a ) 



CSS] 



DF' 



B, 



D, 
-/— 



D 2 



8 



16 



20 



32 



36 47 



The second operand (the source), which 
normally contains one or more decimal 
numbers in the packed format, is changed 
to the zoned format and modified under 
the control of the first operand (the 
pattern). The address of the first 
significant result byte is inserted in 
general register 1. The edited result 
replaces the pattern. 

EDIT AND MARK is identical to EDIT, 
except for the additional function of 
inserting the address of the result byte 
in general register 1 if the result byte 
is a zoned source digit and the signif- 
icance indicator was off before the 
examination. If no result byte meets 
the criteria, general register 1 remains 
unchanged; if more than one result byte 
meets the criteria, the address of the 
rightmost such result byte is inserted. 

In the 24-bit addressing mode, the 
address replaces bits 8-31 of general 
register 1, and bits 0-7 of the register 



are not changed. In the 31-bit address- 
ing mode, the address replaces bits 1-31 
of general register 1, and bit of the 
register is set to zero. 

See the figure "Summary of Editing Func- 
tions" under EDIT for a summary of the 
EDIT and EDIT AND MARK operations. 

Resulting Condi ti on Code ? 



Last field zero or zero length 
Last field less than zero 
Last field greater than zero 



Program Exceptions : 

Access (fetch, operand 2; fetch and 

store, operand 1) 
Data 



Programming Notes 



1. Examples of the use of the EDIT AND 
MARK instruction are given in 
Appendix A. 

2. EDIT AND MARK facilitates the 
programming of floating currency- 
symbol insertion. Using appropri- 
ate source and pattern data, the 
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address inserted in general regis- 
ter 1 is one greater than the 
address where a floating currency- 
sign would be inserted. BRANCH ON 
COUNT (BCTR), with zero in the R a 
fields may be used to reduce the 
inserted address by one. 



No addr 
regi ste 
i ndi cat 
of en 
starter 
source 
general 
er add 
address 
immedi a 
si gni f i 
placed 



ess i s 
r 1 whe 
or is tu 
counteri 
wi th 
digit ze 
regi ste 
ress whe 
of the 
tely fol 
cance 
i n the r 



i nserte 
n the 
rned on 
ng a 

the 
ro. T 
r 1 con 
n thi s 
patte 
lows th 
starter 
egi ster 



d in general 
si gni f i cance 
as a result 
si gni f i cance 
correspond! ng 
o ensure that 
tains a prop- 
occurs* the 
rn byte that 
e appropriate 
could be 
beforehand. 



When multiple fields are edited 
with one execution of the EDIT AND 
MARK instruction, the address, if 
any, inserted in general register 1 
applies to the rightmost field 
edited for which the criteria were 
met . 



The sign of the product is determined by 
the rules of algebra from the multiplier 
and multiplicand signs, even if one or 
both operands are zeros. 



Condi ti on Code J 
unchanged. 

Program Excepti ons t 



The code remains 



Access (fetch, operand 2; fetch and 

store, operand 1) 
Data 
Speci f i cati on 



Programmi ng Notes 



An example of the use of the MULTI- 
PLY DECIMAL instruction is given in 
Appendix A. 

The product cannot exceed 31 digits 
and sign. The leftmost digit of 
the product is always zero. 



See also the programming note under 
EDIT regarding performance degrada- 
tion due to a possible trial 
executi on. 



MULTIPLY DECIMAL 



MP 



D, (L, ,B, ),D 2 (L 2 ,B 2 ) 



CSS] 



FC 



L, 



Bt 



D, 






8 



12 



16 



20 



32 



36 47 



The product of the first operand (the 
multiplicand) and the second operand 
(the multiplier) is placed at the 
first-operand location. The operands 
and result are in the packed format. 

The multiplier length cannot exceed 15 
digits and sign (L 2 not greater than 
seven) and must be less than the multi- 
plicand length (L 2 less than Lj); othei — 
wise, a specification exception is 
recogni zed. 

The multiplicand must have at least as 
many bytes of leftmost zeros as the 
number of bytes in the multiplier? 
otherwise, a data exception is recog- 
nized. This restriction ensures that no 
product overflow occurs. 

The multiplicand, multiplier, and prod- 
uct &re each signed decimal integers in 
the packed format and are right-aligned 
in their fields. All sign and digit 
codes of the multiplicand and multiplier 
are checked for validity. 



SHIFT AND ROUND DECIMAL 



SRP 



D, (L, ,B,),D 2 (B 2 ),I 3 



CSS] 



F0 



L, 



I 3 



B, 



D, 
-/— 



-/ 1 



8 12 16 20 



32 36 47 



The first operand is shifted in the 
direction and for the number of 
decimal-digit positions specified by the 
second-operand address, and, when shift- 
ing to the right is specified, the abso- 
lute value of the first operand is 
rounded by the rounding digit, I 3 . The 
first operand and the result are in the 
packed format. 

The first operand is considered to be in 
the packed-decimal format. Only its 
digit portion is shifted; the sign posi- 
tion does not participate in the shift- 
ing. Zeros are supplied for the vacated 
digit positions. The result replaces 
the first operand. Nothing is stored 
outside of the specified first-operand 
locati on. 

The second-operand address, specified by 
the B 2 and D 2 fields, is not used to 
address dataj bits 26-31 of that address 
are the shift value, and the leftmost 
bits of the address are ignored. 

The shift value is a six-bit signed 
binary integer, indicating the direction 
and the number of decimal-digit posi- 
tions to be shifted. Positive shift 
values specify shifting to the left. 
Negative shift values, which are repres- 
ented in two's complement notation, 
specify shifting to the right. The 
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following are examples of the interpre- 
tation of shift values: 



Programming Notes 



/ 



Shift Value 


Amount and Direction 


011111 


31 digits to the left 


000001 


One digit to the left 


000000 


No shift 


111111 


One digit to the right 


100000 


32 digits to the right 



For a ri 
12-15 of 
decimal r 
and/ whi 
i gnori ng 
mally add 
leftmost 
and by pr 
the left, 
i s then 
vali di ty 
in roundi 
the right 
ignored a 

If one or 
ed out 
overflow 
completed 
i gnori ng 
tion cod 
overflow 
i nterrupt 
occurs, 
right shi 
or when n 



ght shift, the I 3 field, bits 
the instruction, are used as a 
ounding digit. The first oper- 
ch is treated as positive by 
the sign, is rounded by deci- 
i ng the rounding digit to the 
of the digits to be shifted out 
opagating the carry, if any, to 
The result of this addition 
shifted right. Except for 
checking and the participation 
ng, the digits shifted out of 
most decimal-digit position are 
nd are lost. 



more nonzero digits are shift- 
during a left shift, decimal 

occurs. The operation is 
The result is obtained by 
the overflow digits, end condi- 
e 3 is set. If the decimal- 
mask is one, a program 
ion for decimal overflow 

Overflow cannot occur for a 
ft, with or without rounding, 
o shifting is specified. 



In the absence of overflow, the sign of 
a zero result is made positive. If 
overflow occurs, the sign of the result 
is the same as the original sign but 
with the preferred sign code. 

A data exception is recognized when the 
first operand does not have valid sign 
and digit codes or when the rounding 
digit is not a valid digit code. The 
validity of the first-operand codes is 
checked even when no shift is specified, 
and the validity of the rounding digit 
is checked even when no addition for 
rounding takes place. 

Resulti ng Condi ti on Code ? 

Result zero; no overflow 

1 Result less than zero; no over- 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Excepti ons ' 

Access (fetch and store, operand 1) 

Data 

Decimal overflow 



1. Examples of the use of the SHIFT 
AND ROUND instruction are given in 
Appendix A. 

2. SHIFT AND ROUND can be used for 
shifting up to 31 digit positions 
left and up to 32 digit positions 
right. This is sufficient to clear 
all digits of any decimal number 
even with rounding. 

3. For right shifts, the rounding 
digit 5 provides conventional 
rounding of the result. The round- 
ing digit specifies truncation 
without rounding. 

4. When the B 2 field is zero, the 
six-bit shift value is obtained 
directly from bits 42-47 of the 
i nstructi on. 



SUBTRACT DECIMAL 



SP 



D, (Li ,B| ),D 2 (L 2 ,B 2 ) 



[SS] 



FB 



L, 



B, 



D, 
-/— 



3 



8 



12 



16 20 



32 36 47 



The second operand is subtracted from 
the first operand, and the resulting 
difference is placed at the first- 
operand location. The operands and 
result are in the packed format. 

SUBTRACT DECIMAL is executed the same as 
ADD DECIMAL, except that the second 
operand is considered to have a sign 
opposite to the sign in storage. The 
second operand in storage remains 
unchanged. 

Resulting Condi tion Code : 

Result zero; no overflow 

1 Result less than zero; no over- 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Excepti ons : 

Access (fetch, operand 2; fetch and 

store, operand 1) 
Data 
Decimal overflow 
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ZERO AND ADD 



ZAP 



D, (L t ,B t ),D 3 (L 9 ,B 2 ) 



CSS] 



F8 



Li 



B, 



D, 
-/— 



*s 



8 



12 



16 



20 



32 



36 47 



The second operand is placed at the 
first-operand location. The operation 
is equivalent to an addition to zero. 
The operand and result &r& in the packed 
format. 

Only the second operand is checked for 

valid sign and digit codes. Extra zeros 

are supplied on the left for the shorter 
operand if needed. 

If the first operand is too short to 
contain all leftmost nonzero digits of 
the second operand, decimal overflow 
occurs. The operation is completed. 
The result is obtained by ignoring the 
overflow digits* and condition code 3 is 
set. If the decimal-overflow mask is 
one, a program interruption for decimal 
overflow occurs. 

In the absence of overflow, the sign of 
a zero result is made positive. If 
overflow occurs, a zero result is given 



the sign of the second operand but with 
the preferred sign code. 

The two operands may overlap, provided 
the rightmost byte of the first operand 
is coincident with or to the right of 
the rightmost byte of the second 
operand. In this case the result is 
obtained as if the operands were proc- 
essed right to left. 

Resulting Condi ti on Code ? 

Result zero; no overflow 

1 Result less than zero; no over- 
flow 

2 Result greater than zero; no 
overflow 

3 Overflow 

Program Excepti ons t 

Access (fetch, operand 2; store, 

operand 1) 
Data 
Decimal overflow 



Programming Note 



An example of the use of the ZERO AND 
ADD instruction is given in Appendix A. 
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CHAPTER 9. FLOATING-POINT INSTRUCTIONS 



Floating-Point Number Representation 9-1 

Normali zati on 9-2 

Floating-Point-Data Format 9-2 

Instructions 9-4 

ADD NORMALIZED 9-6 

ADD UNNORMALIZED 9-7 

COMPARE 9-8 

DIVIDE 9-8 

HALVE 9-10 

LOAD 9-10 

LOAD AND TEST 9-11 

LOAD COMPLEMENT 9-11 

LOAD NEGATIVE 9-11 

LOAD POSITIVE 9-12 

LOAD ROUNDED 9-12 

MULTIPLY 9-13 

STORE 9-14 

SUBTRACT NORMALIZED 9-14 

SUBTRACT UNNORMALIZED 9-15 



Floating-point instructions are used to 
perform calculations on operands with a 
wide range of magnitude and to yield 
results scaled to preserve precision. 



The floating-point instruct 
for loading, rounding, addin 
ing, comparing, multiplying 
and storing, as well as con 
sign of short, long, and ex 
ands. Short operands gener 
faster processing and requir 
age than long or extended o 
the other hand, long and ex 
ands permit greater pr 
computation. Four floating- 
ters are provided. Instr 
perform either registei — to- 
storage-and-regi ster operati 



ions provide 
g, subtract- 
, di vi di ng, 
trolling the 
tended opei — 
ally permit 
e less stoi — 
perands. On 
tended oper- 
ecision in 
point regis- 
uctions may 
register or 
ons. 



) 



Most of the instructions generate 
normalized results, which preserve the 
highest precision in the operation. For 
addition and subtraction, instructions 
are also provided that generate unnoi — 
malized results. Either normalized or 
unnormalized numbers may be used as 
operands for any floating-point opera- 
tion. 



FLOATING-POINT NUMBER REPRESENTATION 



A floating-point number consists of a 
signed hexadecimal fraction and an 
unsigned seven-bit binary integer called 
the characteristic. The characteristic 
represents a signed exponent and is 
obtained by adding 64 to the exponent 
value (excess-64 notation). The range 
of the characteristic i s to 127, which 



corresponds to an exponent range of -64 
to +63. The value of a floating-point 
number is the product of its fraction 
and the number 16 raised to the power of 
the exponent which is represented by its 
character i sti c. 

The fraction of a floating-point number 
is treated as a hexadecimal number 
because it is considered to be multi- 
plied by a number which is a power of 
16. The name, fraction, indicates that 
the radix point is assumed to be imme- 
diately to the left of the leftmost 
fraction digit. The fraction is repres- 
ented by its absolute value and a 
separate sign bit. The entire number is 
positive or negative, depending on 
whether the sign bit of the fraction is 
zero or one, respectively. 

When a floating-point operation would 
cause the result exponent to exceed 63, 
the characteristic wraps around from 127 
to 0, and an exponent-overflow condition 
exists. The result characteristic is 
then too small by 128. When an opera- 
tion would cause the exponent to be less 
than -64, the characteristic wraps 
around from to 127, and an exponent- 
underflow condition exists. The result 
characteristic is then too large by 128, 
except that a zero characteristic is 
produced when a true zero is forced. 

A true zero is a floating-point number 
with a zero characteristic, zero frac- 
tion, and plus sign. A true zero may 
arise as the normal result of an arith- 
metic operation because of the partic- 
ular magnitude of the operands. The 
result is forced to be a true zero when: 
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1. An exponent underflow occurs and 
the exponent-underflow mask bit in 
the PSW is zero* 

2. The result fraction of an addition 
or subtraction operation is zero 
and the significance mask bit in 
the PSW is zero* or 

3. The operand of the HALVE instruc- 
tion* one or both operands of the 
MULTIPLY instruction, or the divi- 
dend in the DIVIDE instruction has 
a zero fraction. 

When a program interruption for exponent 
underflow occurs, a true zero is not 
forced; instead* the fraction and sign 
remain correct* and the characteristic 
is too large by 128. When a program 
for significance occurs* 
remains zero* the sign is 
the characteristic remains 



i nterrupt i on 
the fraction 
positive* and 
correct. 



The sign of a sum* difference* product* 
or quotient with a zero fraction is 
positive. The sign of a zero fraction 
resulting from other operations is 
established from the operand sign* the 
same as for nonzero fractions. 



In both normalized and unnormalized 
operations* the initial operands need 
not be in normalized form. The operands 
for multiplication and division are 
normalized before the arithmetic 
process. For other normalized opei — 
ations* normalization takes place when 
the intermediate arithmetic result is 
changed to the final result. 

When the intermediate result of 
addition* subtraction* or rounding caus- 
es the fraction to overflow, the frac- 
tion is shifted right by one 
hexadecimal-digit position and the value 
one is supplied to the vacated leftmost 
digit position. The fraction is then 
truncated to the final result length* 
while the characteristic is increased by 
one. This adjustment is made for both 
normalized and unnormalized operations. 



Programmi ng Note 



Up to three leftmost bits of the frac- 
tion of a normalized number may be 
zeros* since the nonzero test applies to 
the entire leftmost hexadecimal digit. 



NORMALIZATION 



FLOATING-POINT-DATA FORMAT 



A quantity can be represented with the 
greatest precision by a floating-point 
number of a given fraction length when 
that number is normalized. A normalized 
floating-point number has a nonzero 
leftmost hexadecimal fraction digit. If 
one or more leftmost fraction digits are 
zeros* the number is said to be unnor- 
mali zed. 

Unnormalized numbers &re normalized by 
shifting the fraction left* one digit at 
a time* until the leftmost hexadecimal 
digit is nonzero and reducing the char- 
acteristic by the number of hexadecimal 
digits shifted. A number with a zero 
fraction cannot be normalized* its char- 
acteristic either remains unchanged* or 
it is made zero when the result is 
forced to be a true zero. 

Addition and subtraction with extended 
operands* as well as the MULTIPLY* 
DIVIDE* and HALVE operations* are 
performed only with normalization. 
Addition and subtraction with short or 
long operands may be specified as either 
normalized or unnormalized. For all 
other operations* the result is produced 
without normalization. 

With unnormalized operations* leftmost 
zeros in the result fraction are not 
eliminated. The result may or may not 
be in normalized form* depending upon 
the original operands. 



Floating-point numbers have a 32-bit 
(short) format* a 64-bit (long) format* 
or a 128-bit (extended) format. Numbers 
in the short and long formats may be 
designated as operands both in storage 
and in the floating-point registers* 
whereas operands having the extended 
format can be designated only in the 
floating-point registers. 

The floating-point registers contain 64 
bits each and are numbered 0* 2* 4* and 
6. A short or long floating-point 
number requires a single floating-point 
register. An extended floating-point 
number requires a pair of these regis- 
ters*, either registers and 2 or 
registers 4 and 6; the two register 
pairs are designated as or 4* respec- 
tively. When the Ri or R 2 field of a 
floating-point instruction designates 
any register number other than 0* 2, 4* 
or 6 for the short or long format* or 
any regi ster number other than or 4 
for the extended format* a program 
interruption for specification exception 
occurs. 

Short Floating-Point Number 



Characteri sti c 



6-Digit Fraction 

/ 



1 



31 



i 
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Long Floating-Point Number 



the high-order 
flows. 



characteristic under- 



Characteri sti c 



14-Digit Fraction 

/ 



1 



Extended Floating-Point Number 

High-Order Part 

/ 



63 



Hi gh-Order 
Characteri sti c 



Leftmost 14 Digits 
of 28-Digit Fraction 

/ 



1 



8 



Low-Order Part 



63 



Low-Order 
Characteri stic 



Rightmost 14 Digits 
of 28-Digit Fraction 

/ 



64 



72 



127 



In all formats, the first bit (bit 0) is 
the sign bit (S). The next seven bits 
are the characteristic. In the short 
and long formats, the remaining bits 
constitute the fraction, which consists 
of six or 14 hexadecimal digits, respec- 
ti vely. 

A short floating-point number occupies 
only the leftmost 32 bit positions of a 
floating-point register. The rightmost 
32 bit positions of the register are 
ignored when used as an operand in the 
short format and remain unchanged when a 
short result is placed in the register. 

An extended floating-point number has a 
28-digit fraction and consists of two 
long floating-point numbers which are 
called the high-order and low-order 
parts. The high-order part may be any 
long floating-point number. The frac- 
tion of the high-order part contains the 
leftmost 14 hexadecimal digits of the 
28-digit fraction. The characteristic 
and sign of the high-order part are the 
characteristic and sign of the extended 
floating-point number. If the high- 
order part is normalized, the extended 
number is considered normalized. The 
fraction of the low-order part contains 
the rightmost 14 digits of the 28-digit 
fraction. The sign and characteristic 
of the low-order part of an extended 
operand are ignored. 



When a result in the exten 
placed in a register pair, 
the low-order part is made 
that of the high-order part 
the result is a true zero, 
characteristic is made 14 
high-order characteristic, 
subtraction of 14 would ca 
order characteristic to bee 
zero, the characteristic 
greater than its correct 
nent underflow is indicat 



ded format is 

the sign of 

the same as 

, and, unless 

the low-order 

less than the 

When the 

use the low- 

ome less than 

is made 128 

value. Expo- 

ed only when 



When an extended result is made a true 
zero, both the high-order and low-order 
parts are made a true zero. 

The range covered by the magnitude (M) 
of a normalized floating-point number 
depends on the format. 

In the short format: 

16~ 65 < M < (1 - 16"*) x 16* 3 
In the long format: 

16~ 65 < M < (1 - 16~ l «) x 16 63 
In the extended format: 

16"* 5 < M < (1 - 16" 28 ) x 16* 3 
In all formats, approximately: 

5.4 x 10~ 79 < M < 7.2 x 10 75 

Although the final result of a 
floating-point operation has six hexade- 
cimal fraction digits in the short 
format, 14 fraction digits in the long 
format, and 28 fraction digits in the 
extended format, intermediate results 
have one additional hexadecimal digit on 
the right. This digit is called the 
guard digit. The guard digit may 
increase the precision of the final 
result because it participates in addi- 
tion, subtraction, and comparison 
operations and in the left shift that 
occurs during normalization. 

The entire set of floating-point oper- 
ations is available for both short and 
long operands. The instructions gener- 
ate a result that has the same format as 
the operands, except that for MULTIPLY, 
a long product is produced from a short 
multiplier and multiplicand. Floating- 
point operations in the extended format 
are available only for normalized addi- 
tion, subtraction, multiplication, and 
division. MULTIPLY can also generate an 
extended product from a long multiplier 
and multiplicand. LOAD ROUNDED provides 
for rounding from extended to long 
format or from long to short format. 



Programming Notes 



A long floating-point number can be 
converted to the extended format by 
appending any long floating-point 
number having a zero fraction, 
including a true zero. Conversion 
from the extended to the long 
format can be accomplished by trun- 
cation or by means of the LOAD 
ROUNDED instruction. 



Chapter 9. Floating-Point Instructions 9-3 



In the absence of an exponent ovei — 
flow or exponent underflow, the 
long floating-point number consti- 
tuting the low-order part of an 
extended result correctly expresses 
the value of the low-order part of 
the extended result when the char — 
acteristic of the high-order part 
is 14 or higher. This applies also 
when the result is a true zero. 
When the high-order characteristic 
is less than 14 but the number is 
not a true zero* the low-order 
part, when considered as a long 
floating-point number, does not 
express the correct characteristic 
value. 

The entire fraction of an extended 
result participates in normaliza- 
tion. The low-order part alone may 
or may not appear to be a normal- 
ized long floating-point number, 
depending on whether the 15th digit 
of the normalized 28-digit fraction 
is nonzero or zero. 



Mnemonics for the floating-point 
instructions have an R as the last 
letter when the instruction is in the RR 
format. For instructions where all 
operands are the same length, certain 
letters &r& used to represent operand- 
format length and normalization, as 
follows: 

E Short normalized 

U Short unnormalized 

D Long normalized 

W Long unnormalized 

X Extended normalized 

Note : In the detailed descriptions of 
the individual instructions, the mnemon- 
ic and the symbolic operand designation 
for the assembler language are shown 
with each instruction. For a register- 
to-register operation using LOAD 
(short), for example, LER is the mnemon- 
ic and R t ,R 2 the operand designation. 



Programmi ng Note 



INSTRUCTIONS 



The floating-point instructions and 
their mnemonics, formats, and operation 
codes are listed in the figure "Summary 
of Floating-Point Instructions." The 
figure also indicates when the condition 
code is set and the exceptional condi- 
tions in operand designations, data, or 
results that cause a program intei — 
rupti on. 



The only difference between the 
floating-point instructions for the 
370-XA mode and the System/370 mode is 
that, in the 370-XA mode, DIVIDE with 
extended operands (DXR) has been added, 
and the floating-point instructions, 
including the extended-precision 
instructions, are part of the standard 
instruction set. 
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Mne- 














Op 


Name 


moni c 






Cha 


racteri 


sties 




Code 


ADD NORMALIZED (extended) 


AXR 


RR 


C 




SP 


EU 


EO 


LS 




36 


ADD NORMALIZED (long) 


ADR 


RR 


C 




SP 


EU 


EO 


LS 




2A 


ADD NORMALIZED (long) 


AD 


RX 


C 


A 


SP 


EU 


EO 


LS 




6A 


ADD NORMALIZED (short) 


AER 


RR 


C 




SP 


EU 


EO 


LS 




3A 


ADD NORMALIZED (short) 


AE 


RX 


C 


A 


SP 


EU 


EO 


LS 




7A 


ADD UNNORMALIZED (long) 


AWR 


RR 


C 




SP 




EO 


LS 




2E 


ADD UNNORMALIZED (long) 


AN 


RX 


C 


A 


SP 




EO 


LS 




6E 


ADD UNNORMALIZED (short) 


AUR 


RR 


C 




SP 




EO 


LS 




3E 


ADD UNNORMALIZED (short) 


AU 


RX 


C 


A 


SP 




EO 


LS 




7E 


COMPARE (long) 


CDR 


RR 


C 




SP 










29 


COMPARE (long) 


CD 


RX 


C 


A 


SP 










69 


COMPARE (short) 


CER 


RR 


C 




SP 










39 


COMPARE (short) 


CE 


RX 


C 


A 


SP 










79 


DIVIDE (extended) 


DXR 


RRE 






SP 


EU 


EO FK 






B22D 


DIVIDE (long) 


DDR 


RR 






SP 


EU 


EO FK 






2D 


DIVIDE (long) 


DD 


RX 




A 


SP 


EU 


EO FK 






6D 


DIVIDE (short) 


DER 


RR 






SP 


EU 


EO FK 






3D 


DIVIDE (short) 


DE 


RX 




A 


SP 


EU 


EO FK 






7D 


HALVE (long) 


HDR 


RR 






SP 


EU 








24 


HALVE (short) 


HER 


RR 






SP 


EU 








34 


LOAD (long) 


LDR 


RR 






SP 










28 


LOAD (long) 


LD 


RX 




A 


SP 










68 


LOAD (short) 


LER 


RR 






SP 










38 


LOAD (short) 


LE 


RX 




A 


SP 










78 


LOAD AND TEST (long) 


LTDR 


RR 


C 




SP 










22 


LOAD AND TEST (short) 


LTER 


RR 


C 




SP 










32 


LOAD COMPLEMENT (long) 


LCDR 


RR 


C 




SP 










23 


LOAD COMPLEMENT (short) 


LCER 


RR 


C 




SP 










33 


LOAD NEGATIVE (long) 


LNDR 


RR 


C 




SP 










21 


LOAD NEGATIVE (short) 


LNER 


RR 


c 




SP 










31 


LOAD POSITIVE (long) 


LPDR 


RR 


c 




SP 










20 


LOAD POSITIVE (short) 


LPER 


RR 


c 




SP 










30 


LOAD ROUNDED (ext. to long) 


LRDR 


RR 






SP 




EO 






25 


LOAD ROUNDED (long to short) 


LRER 


RR 






SP 




EO 






35 


MULTIPLY (extended) 


MXR 


RR 






SP 


EU 


EO 






26 


MULTIPLY (long) 


MDR 


RR 






SP 


EU 


EO 






2C 


MULTIPLY (long) 


MD 


RX 




A 


SP 


EU 


EO 






6C 


MULTIPLY (long to extended) 


MXDR 


RR 






SP 


EU 


EO 






27 


MULTIPLY (long to extended) 


MXD 


RX 




A 


SP 


EU 


EO 






67 


MULTIPLY (short to long) 


MER 


RR 






SP 


EU 


EO 






3C 


MULTIPLY (short to long) 


ME 


RX 




A 


SP 


EU 


EO 






7C 


STORE (long) 


STD 


RX 




A 


SP 








ST 


60 


STORE (short) 


STE 


RX 




A 


SP 








ST 


70 


SUBTRACT NORMALIZED (ext.) 


SXR 


RR 


c 




SP 


EU 


EO 


LS 




37 


SUBTRACT NORMALIZED (long) 


SDR 


RR 


c 




SP 


EU 


EO 


LS 




2B 


SUBTRACT NORMALIZED (long) 


SD 


RX 


c 


A 


SP 


EU 


EO 


LS 




6B 


SUBTRACT NORMALIZED (short) 


SER 


RR 


c 




SP 


EU 


EO 


LS 




3B 


SUBTRACT NORMALIZED (short) 


SE 


RX 


c 


A 


SP 


EU 


EO 


LS 




7B 


SUBTRACT UNNORMALIZED (long) 


SWR 


RR 


c 




SP 




EO 


LS 




2F 


SUBTRACT UNNORMALIZED (long) 


SW 


RX 


c 


A 


SP 




EO 


LS 




6F 


SUBTRACT UNNORMALIZED (short) 


SUR 


RR 


c 




SP 




EO 


LS 




3F 


SUBTRACT UNNORMALIZED (short) 


SU 


RX 


c 


A 


SP 




EO 


LS 




7F 



Summary of Floating-Point Instructions (Part 1 of 2) 
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Explanati on : 

A Access exceptions for logical addresses. 

C Condition code is set. 

EO Exponent-overflow exception. 

EU Exponent-underflow exception. 

FK Floating-point-divide exception. 

LS Significance exception. 

RR RR instruction format. 

RRE RRE instruction format. 

RX RX instruction format. 

SP Specification exception. 

ST PER storage-alteration event. 



Summary of Floating-Point Instructions (Part 2 of 2) 



ADD NORMALIZED 



AER R,,R. 



[RR, Short Operands] 



^A" 


Ri 


R 2 



8 12 15 



AE R,,D 2 (X 2 ,B 2 ) [RX, Short Operands] 



^A' 


Ri 


x 2 


B 2 


D a 



8 12 16 20 



31 



ADR R|*R] 



[RR, Long Operands] 



»2A' 


R, 


R 2 



8 12 15 



AD Ri,D 2 (X 2 ,B 2 ) [RX, Long Operands] 



f 6A' 


R, 


X a 


B a 


D 2 



8 12 16 20 



31 



AXR R i , R] 



[RR, Extended Operands] 



»36 f 


Ri 


R 2 



8 



12 15 



The second operand is added to the first 
operand, and the normalized sum is 
placed at the first-operand location. 



Addition of two floating 
consists in characterist 
fraction alignment, and 
addition. The character 
two operands are compared 
tion accompanying 
characteristic is aligned 
fraction by a right sh 
characteristic increased 



-point numbers 
ic comparison, 
signed fraction 
i sties of the 
, and the frac- 
the smaller 
with the other 
ift, with its 
by one for each 



hexadecimal digit of shift until the two 
characteristics agree. 



When a fraction i 
alignment, the 
digit shifted out 
digit. The fract 
is considered to 
in the guard-dig 
alignment shift 
are considered to 
in the guard-digi 
tions with si 
algebraically to 
diate sum. 



s shifted right during 

leftmost hexadecimal 

is retained as a guard 

ion that is not shifted 

be extended with a zero 

it position. When no 

occurs, both operands 

be extended with zeros 

t position. The frac- 

gns are then added 

form a signed interme- 



The intermediate-sum fraction consists 
of seven (short format), 15 (long 
format), or 29 (extended format) hexade- 
cimal digits, including the guard digit, 
and a possible carry. If a carry is 
present, the sum is shifted right one 
digit position so that the carry becomes 
the leftmost digit of the fraction, and 
the characteristic is increased by one. 

If the addition produces no carry, the 
intermediate-sum fraction is shifted 
left as necessary to eliminate any lead- 
ing hexadecimal zero digits resulting 
from the addition, provided the fraction 
is not zero. Zeros are supplied to the 
vacated rightmost digits, and the chai — 
acteristic is reduced by the number of 
hexadecimal digits of shift. The frac- 
tion thus normalized is then truncated 
on the right to six (short format), 14 
(long format), or 28 (extended format) 
hexadecimal digits. In the extended 
format, a characteristic is generated 
for the low-order part, which is 14 less 
than the high-order characteristic. 

The sign of the sum is determined by the 
rules of algebra, unless all digits of 
the intermediate-sum fraction are zero, 
in which case the sign is made plus. 

An exponent-overflow exception is recog- 
nized when a carry from the leftmost 
position of the intermediate-sum frac- 
tion would cause the characteristic of 
the normalized sum to exceed 127. The 
operation is completed by making the 
result characteristic 128 less than the 
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correct value* and a program intei — 
ruption for exponent overflow takes 
place. The result sign and fraction 
remain correct* and* for AXR* the char — 
acteristic of the low-order part remains 
correct. 

An exponent-underflow exception is 
recognized when the characteristic of 
the normalized sum would be less than 
zero and the fraction is not zero. If 
the exponent-underflow mask bit is one* 
the operation is completed by making the 
result characteristic 128 greater than 
the correct value. The result sign and 
fraction remain correct* and a program 
interruption for exponent underflow 
takes place. When exponent underflow 
occurs and the exponent-underflow mask 
bit is zero* a program interruption does 
not take place; instead* the operation 
is completed by making the result a true 
zero. For AXR* no exponent underflow is 
recognized when the characteristic of 
the low-order part would be less than 
zero but the characteristic of the 
high-order part is zero or greater. 



The result fraction i 
intermediate-sum fracti 
guard digit* is zero 
result fraction* the a 
the setting of the s 
bit. If the significa 
one* no normalization o 
mediate and final resul 
are the same* and a pro 
for significance takes 
significance mask bit 
program interruption 
instead* the result is 



s zero when the 

on* including the 

With a zero 

ction depends on 

ignificance mask 

nee mask bit is 

ccurs* the intei — 

t characteristics 

gram interruption 

place. If the 

i s zero* the 

does not occur* 

made a true zero. 



The R, field for AER* AE* ADR* and AD, 

and the R 2 field for AER and ADR must 

designate register 0* 2* 4* or 6. The 
Ri and R 2 fields for AXR must designate 

register or 4. Otherwise* a specifi- 
cation exception is recognized. 

Resulti ng Condi ti on Code : 



Result fraction zero 
Result less than zero 
Result greater than zero 



Program Excepti ons '- 

Access (fetch* operand 2 of AE and 

AD only) 
Exponent overflow 
Exponent underflow 
Si gni f i cance 
Speci f i cati on 



Programmi ng Notes 



An example 
NORMALIZED 
Appendix A, 



of the use of 
instruction is 



the ADD 
given in 



Interchanging the two operands in a 
floating-point addition does not 
affect the value of the sum. 

The ADD NORMALIZED instruction 
normalizes the sum but not the 
operands. Thus* if one or both 
operands are unnormal i zed* preci- 
sion may be lost during fraction 
al i gnment . 



ADD UNNORMALIZED 



AUR R,,R a 



[RR, Short Operands] 



f 3E f 


Ri 


R 2 



8 12 15 



AU R,,D a (X 2 ,B 2 ) CRX, Short Operands] 



»7E f 


Ri 


X 2 


B 2 


D 2 



8 12 16 20 



31 



AWR R,,R a 



[RR* Long Operands] 



f 2E f 


Ri 


R 2 



AW 



8 12 15 



Ri*D 2 (X 2 *B 2 ) [RX, Long Operands] 



»6E» 


R, 


x a 


B 2 


D a 



8 



12 



16 



20 



31 



The second operand is added to the first 
operand* and the unnormal i zed sum is 
placed at the first-operand location. 



The execution 
identical to 
except that: 



of ADD UNNORMALIZED is 
that of ADD NORMALIZED* 



1. When no carry is present after the 
addition* the intermediate-sum 
fraction is truncated to the proper 
result-fraction length without a 
left shift to eliminate leading 
hexadecimal zeros and without the 
corresponding reduction of the 
characteri sti c. 

2. Exponent underflow cannot occur. 

3. The guard digit does not partici- 
pate in the recognition of a zero 
result fraction. A zero result 
fraction is recognized when the 
fraction (that is, the intei — 
mediate-sum fraction* excluding the 
guard digit) is zero. 
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The Ri and R 2 fields must designate 
register 0> 2, 4, or 6; otherwise, a 
specification exception is recognized. 

Resulti ng Condition Code : 



Result fraction zero 
Result less than zero 
Result greater than zero 



Program Exceptions ? 

Access (fetch, operand 2 of AU and 

AW only) 
Exponent overflow 
Si gni f i cance 
Specif i cati on 



The first operand is compared with the 
second operand, and the condition code 
is set to indicate the result. 

The comparison is algebraic and follows 
the procedure for normalized floating- 
point subtraction, except that the 
difference is discarded after setting 
the condition code and both operands 
remain unchanged. When the difference, 
including the guard digit, is zero, the 
equal. When a nonzero 
positive or negative, the 
is high or low, respec- 



operands are 
difference is 
first operand 
ti vely. 



An exponent-overflow, exponent- 
underflow, or significance exception 
cannot occur. 



Programmi ng Notes 



An example of the use of the ADD 
UNNORMALIZED instruction is given 
in Appendix A. 

Except when the result is made a 
true zero, the characteristic of 
the result of ADD UNNORMALIZED is 
equal to the greater of the two 
operand characteristics, increased 
by one if the fraction addition 
produced a carry, or set to zero if 
exponent overflow occurred. 



The R t and R 2 fields must designate 
register 0, 2, 4, or 6; otherwise, a 
specification exception is recognized. 

Resulti ng Condi ti on Code: 



Operands equal 
First operand low 
First operand high 



Program Exceptions : 

Access (fetch, operand 2 

CD only) 
Specification 



of CE and 



COMPARE 



Programming Notes 



CER R,,R, 



[RR, Short Operands] 



f 39» 


Rt 


R 3 



8 12 15 



CE R t ,D a (X a ,B a ) tRX, Short Operands] 



f 79 . 


Ri 


x a 


B a 


D a 



8 12 16 20 



31 



1. 



2. 



3. 



Examples of 
instructi on 
A. 



the use of the COMPARE 
are given in Appendix 



An exponent inequality alone is not 
sufficient to determine the 
inequality of two operands with the 
same sign, because the fractions 
may have different numbers of lead- 
ing hexadecimal zeros. 

Numbers with zero fractions compare 
equal even when they differ in sign 
or characteristic. 



CDR Ri,R a 



[RR, Long Operands] 



» 29 f 


Ri 


R 2 



8 12 15 



CD Ri,D a (X a ,B 2 ) [RX, Long Operands] 



»69» 


Ri 


x a 


B a 


D a 



8 12 16 20 



31 



DIVIDE 



DER Ri,R a 



CRR, Short Operands] 



»3D» 


Ri 


R 2 



8 12 15 
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DE R t ,D 2 (X 2 ,B 2 ) [RX, Short Operands] 



'7D' 


Ri 


X 2 


B 2 


D 2 



8 12 16 20 



31 



DDR Ri»R a 



[RR, Long Operands] 



f 2D' 


Ri 


R a 



8 12 15 



DD R,,D 2 (X 2 ,B 2 ) ERX, Long Operands] 



'6D' 


Rt 


X 2 


B a 


D 2 



8 12 16 20 



31 



DXR 



R i » Rj 



[RRE, Extended Operands] 



'8220* 


//////// 


Ri 


R a 



16 



24 



28 31 



The first operand (the dividend) is 
divided by the second operand (the divi- 
sor) , and the normalized quotient is 
placed at the first-operand location. 
No remainder is preserved. 

Floating-point division consists in 
characteristic subtraction and fraction 
division. The operands are first 
normalized to eliminate leading hexade- 
cimal zeros. The difference between the 
dividend and divisor characteristics of 
the normalized operands, plus 64, is 
used as the characteristic of an inter- 
mediate quotient. 



All div 
parti ci 
the 

interme 
no lea 
right s 
necessa 
acteri s 
truncat 
length. 



idend and d 
pate in fo 
i ntermediat 
diate-quoti 
ding hexad 
hift of one 
ry with an 
tic by one. 
ed to the 



i visor frac 
rming the 
e quotie 
ent fractio 
ecimal zer 
digit posi 
increase o 
The fract 
proper resu 



tion digits 
fraction of 
nt . The 
n can have 
os, but a 
tion may be 
f the char- 
ion is then 
lt-f racti on 



An exponent-overflow exception is recog- 
nized when the characteristic of the 
final quotient would exceed 127 and the 
fraction is not zero. The operation is 
completed by making the characteristic 
128 less than the correct value. If, 
for the DIVIDE (DXR) instruction, the 
low-order characteristic would also 
exceed 127, it, too, is decreased by 
128. The result is normalized, and the 
sign and fraction remain correct. A 
program interruption for exponent over- 
flow occurs. 



An exponent-underflow exception exists 
when the characteristic of the final 
quotient would be less than zero and the 
fraction is not zero. If the exponent- 
underflow mask bit is one, the operation 
is completed by making the character- 
istic 128 greater than the correct 
value, and a program interruption for 
exponent underflow occurs. The result 
is normalized, and the sign and fraction 
remain correct. If the exponent- 
underflow mask bit is zero, a program 
interruption does not take place; 
instead, the operation is completed by 
making the quotient a true zero. For 
the DXR instruction, exponent underflow 
is not recognized when the low-order 
characteristic is less than zero but the 
high-order characteristic is equal to or 
greater than zero. 

Exponent underflow does not occur when 
an operand characteristic becomes less 
than zero during normalization of the 
operands or when the intermediate- 
quotient characteristic is less than 
zero, as long as the final quotient can 
be represented with the correct charac- 
terise c. 

When the divisor fraction is zero, a 
floating-point-divide exception is 
recognized. This includes the case of 
division of zero by zero. 

When the dividend fraction is zero, but 
the divisor fraction is nonzero, the 
quotient is made a true zero. No expo- 
nent overflow or exponent underflow 
occurs. 

The sign of the quotient is determined 
by the rules of algebra, except that the 
sign is always plus when the quotient is 
made a true zero. 

The R, field for DER, DE, DDR, and DD, 
and the R 2 field for DER and DDR, must 
designate register 0, 2, 4, or 6. The 
Ri and R 2 fields for DXR must designate 
register or 4. Otherwise, a specifi- 
cation exception is recognized. 



Condi ti on 
unchanged. 



Code; 



The 



code remains 



Program Excepti ons : 

Access (fetch, operand 2 of DD and 

DE only) 
Exponent overflow 
Exponent underflow 
Floating-point divide 
Specif icati on 



Programming Note 



Examples of the use of the DIVIDE 
instruction are given in Appendix A. 
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HALVE 



Programming Notes 



HER R t t K2 



[RR, Short Operands] 



f 34» 


Ri 


R 2 



8 12 15 



HDR 



R 1 * Ra 



[RR, Long Operands] 



»2«» 


Ri 


R2 







8 



12 15 



The second operand is divided by 2, and 
the normalized quotient is placed at the 
first-operand location. 



The fraction of the 
shifted right one b 
the contents of the 
tion in the leftmost 
guard digit, and a 
the leftmost bit po 
tion. The i nt 
including the guar 
normalized, and th 
truncated to the pro 



second operand i s 
it position, placing 
rightmost bit posi- 
bit position of the 
zero is supplied to 
sition of the frac- 
ermediate result, 
d digit, is then 
e final result is 
per length. 



An exponent-underf Ion exception exists 
Nhen the characteristic of the final 
result would be less than zero and the 
fraction is not zero. If the exponent- 
underflow mask bit is one, the operation 
is completed by making the charactei — 
istic 128 greater than the correct 
value, and a program interruption for 
exponent underflow occurs. The result 
is normalized, and the sign and fraction 
remain correct. If the exponent- 
underflow mask bit is zero, a program 
interruption does not take place; 
instead, the operation is completed by 
making the result a true zero. 

When the fraction of the second operand 
is zero, the result is made a true zero, 
and no exponent underflow occurs. 

The sign of the result is the same as 
that of the second operand, except that 
the sign is always plus when the 
quotient is made a true zero. 

The Rj and R a fields must designate 
register 0, 2, 4, or 6; otherwise, a 
specification exception is recognized. 



Condi ti on Code ? 
unchanged. 

Program Excepti ons ? 



Exponent underflow 
Speci f i cati on 



The code 



remains 



An example of the use of the HALVE 
instruction is given in Appendix A. 



With short and 
halve operation 
divide operation 
as divisor. Sim 
of HDR is ident 
or MDR with one- 
er. No mu 
corresponds to H 
ply operation 
results. 



long operands, the 
is identical to a 
with the number 2 
ilarly, the result 
ical to that of MD 
half as a multipli- 
ltiply operation 
ER, since no multi- 
produces short 



The result of HALVE is zero only 
when the second-operand fraction is 
zero, or when exponent underflow 
occurs with the exponent-underflow 
mask set to zero. A fraction with 
zeros in every bit position, except 
for a one in the rightmost bit 
position, does not become zero 
after the right shift. This is 
because the one bit is preserved in 
the guard-digit position and, when 
the result is not made a true zero 
because of exponent underflow, 
becomes the leftmost bit after 
normalization of the result. 



LOAD 



LER R,,R. 



[RR, Short Operands] 



'38' 


Ri 


R a 



8 12 15 



LE R,,D 2 (X a ,B a ) [RX, Short Operands] 



f 78' 


Ri 


X 2 


B 2 


D 2 



8 12 16 20 



31 



LDR Rt,R a 



[RR, Long Operands] 



'28* 


Ri 


R 2 



8 12 15 



LD Ri,D 2 (X 2 ,B 2 ) [RX, Long Operands] 



'68' 


Ri 


X a 


B a 


D a 



8 12 16 20 



31 



The second operand i s placed unchanged 
at the first-operand location. 
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The Ri and R a fields must designate 
register 0* 2* 4* or 6; otherwise* a 
specification exception is recognized. 



Condi ti on 
unchanged. 



Code: 



The code remains 



Program Excepti ons : 



Access (fetch* operand 2 

LD only) 
Speci f i cati on 



of LE and 



LOAD COMPLEMENT 



LCER R,,R a 



ERR, Short Operands] 



»33» 


R. 


R 2 



8 12 15 



LCDR R,,R, 



[RR* Long Operands] 



LOAD AND TEST 



LTER R,,R a 



[RR* Short Operands] 



'32' 


Ri 


R 3 



8 12 15 



LTDR R,*R a 



[RR* Long Operands] 



•22' 


Ri 


R a 



8 



12 15 



The second operand is placed unchanged 
at the first-operand location* and its 
sign and magnitude are tested to deter- 
mine the setting of the condition code. 

The Ri and R a fields must designate 
register 0* 2* 4* or 6; otherwise* a 
specification exception is recognized. 

Resulti ng Condi ti on Code: 



Result fraction zero 
Result less than zero 
Result greater than zero 



Program Excepti ons ? 
Speci f i cation 



*ZZ' 


R. 


Ra 



8 



12 15 



The second operand i s placed at the 
first-operand location with the sign bit 
i nverted. 

The sign bit is inverted* even if the 
fraction is zero. The characteristic 
and fraction are not changed. 

The R« and R a fields must designate 
register 0* 2* 4* or 6* otherwise* a 
specification exception is recognized. 

Resulti ng Condi ti on Code ? 



Result fraction zero 
Result less than zero 
Result greater than zero 



Program Excepti ons : 
Speci f i cati on 

LOAD NEGATIVE 
LNER R t *R 2 



[RR* Short Operands] 



f 31» 


Rt 


R 2 



8 12 15 



Programmi ng Note 



When the same register is designated as 
the first-operand and second-operand 
location* the operation is equivalent to 
a test without data movement. 



LNDR R,*R a 



'21 f 


Ri 


R a 



8 



12 15 



[RR* Long Operands] 



The second operand i s placed at the 
first-operand location with the sign 
made minus. 

The sign bit is made one* even if the 
fraction is zero. The characteristic 
and fraction are not changed. 

The Rt and R 2 fields must designate 
register 0* 2* 4* or 6* otherwise* a 
specification exception is recognized. 
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Resulting Condi ti on Code ? 



LRDR R t ,R 2 



Result fraction zero 

1 Result less than zero 
2 

3 

Program Excepti ons : 
Specif icati on 



LOAD POSITIVE 



LPER R,,R 2 



ERR, Short Operands] 



»30» 


Rt 


Ra 



8 12 15 



LPDR R,,R 2 



[RR, Long Operands] 



•zp- 


R, 


R a 



8 



12 15 



The second operand is placed at the 
first-operand location with the sign 
made plus. 

The sign bit is made zero. The charac- 
teristic and fraction are not changed. 

The Rt and R 2 fields must designate 
register 0, 2, 4, or 6; otherwise, a 
specification exception is recognized. 



Resulting Condi ti on Code : 

Result fraction zero 

1 

2 Result greater than zero 



Program Exceptions ? 
Specif i cation 

LOAD ROUNDED 

LRER R,,R 2 
[RR, Long Operand 2, Short Operand 1] 



'35' 


R. 


Ra 



[RR, Extended Operand 2, 
Long Operand 1] 



♦25' 


Ri 


Ra 



8 



12 15 



The second operand i s rounded to the 
next shorter format, and the result is 
placed at the first-operand location. 

Rounding consists in adding a one in bit 
position 32 or 72 of the long or 
extended second operand, respectively, 
and propagating any carry to the left. 
The sign of the fraction is ignored, and 
addition is performed as if the frac- 
tions were positive. 

If rounding causes a carry out of the 

leftmost hexadecimal digit position of 
the fraction, the fraction is shifted 

right one digit position so that the 

carry becomes the leftmost digit of the 

fraction, and the characteristic is 
increased by one. 

The intermediate fraction is then trun- 
cated to the proper result-fraction 
length. 

The sign of the result is the same as 
the sign of the second operand. There 
is no normalization to eliminate leading 
zeros. 

An exponent-overflow exception exists 
when shifting the fraction right would 
cause the characteristic to exceed 127. 
The operation is completed by loading a 
number whose characteristic is 128 less 
than the correct value, and a program 
interruption for exponent overflow 
occurs. The result is normalized, and 
the sign and fraction remain correct. 



Exponent-underflow and 
exceptions cannot occur. 



si gni f i cance 



The Ri field must designate register 0, 
2, 4, or 6; the R 2 field of LRER must 
designate register 0, 2, 4, or 6; and 
the R 2 field of LRDR must designate 
register or 4. Otherwise, a specifi- 
cation exception is recognized. 



Condi ti on 
unchanged, 



Code: 



The code 



remains 



8 12 15 



Program Exceptions : 

Exponent overflow 
Speci f i cation 
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MULTIPLY 



MER R,,R a 



CRR, Short Multiplier and Multi pi i cand, 
Long Product] 



»3C f 


Ri 


R a 



8 12 15 



ME R,,D a (X a ,B a ) 

[RX, Short Multiplier and Multiplicand, 
Long Product] 



'7C 


Ri 


X a 


B a 


D a 



8 12 16 20 



31 



MDR R,,R a 



[RR, Long Operands] 



»2C» 


R, 


R a 



8 12 15 



MD R,,D a (X a ,B a ) [RX, Long Operands] 



»6C» 


R. 


x a 


B a 


D a 



8 12 16 20 



31 



MXDR R,,R a 

CRR, Long Multiplier and Multiplicand, 
Extended Product] 



f 27 f 


Ri 


R a 



8 12 15 



MXD R,,D a (X a ,B a ) 

[RX, Long Multiplier and Multiplicand, 
Extended Product] 



Multiplication of two floating-point 
numbers consists in exponent addition 
and fraction multiplication. The opei — 
ands are first normalized to eliminate 
leading hexadecimal zeros. The sum of 
the characteristics of the normalized 
operands, less 64, is used as the chai — 
acteristic of the intermediate product. 

The fraction of the intermediate product 
is the exact product of the normalized 
operand fractions. When the 
intermediate-product fraction has one 
leading hexadecimal zero digit, the 
fraction is shifted left one digit posi- 
tion, bringing the contents of the 
guard-digit position into the rightmost 
position of the result fraction, and the 
intermediate-product characteristic is 
reduced by one. The fraction is then 
truncated to the proper result-fraction 
length. 

For MER and ME, the multiplier and 
multiplicand fractions have six hexade- 
cimal digits; the product fraction has 
the full 14 digits of the long format, 
with the two rightmost fraction digits 
always zeros. For MDR and MD, the 
multiplier and multiplicand fractions 
have 14 digits, and the final product 
fraction is truncated to 14 digits. For 
MXDR and MXD, the multiplier and multi- 
plicand fractions have 14 digits, with 
the multiplicand occupying the high- 
order part of the first operand; the 
final product fraction contains 28 
digits and is an exact product of the 
operand fractions. For MXR, the multi- 
plier and multiplicand fractions have 28 
digits, and the final product fraction 
is truncated to 28 digits. 

An exponent-overflow exception is recog- 
nized when the characteristic of the 
final product would exceed 127 and the 
fraction is not zero. The operation is 
completed by making the characteristic 
128 less than the correct value. If, 
for extended results, the low-order 
characteristic would also exceed 127, 
it, too, is decreased by 128. The 
result is normalized, and the sign and 
fraction remain correct. A program 
interruption for exponent overflow 
occurs. 



f 67' 


Ri 


X a 


B a 


D a 



8 12 16 20 



31 



MXR R,,R a 



[RR, Extended Operands] 



'26* 


R, 


Ra 



8 



12 15 



The normalized product of the second 
operand (the multiplier) and the first 
operand (the multiplicand) is placed at 
the first-operand location. 



Exponent overflow is not recognized when 
the intermediate-product characteristic 
is initially 128 but is brought back 
within range by normalization. 

An exponent-underflow exception exists 
when the characteristic of the final 
product would be less than zero and the 
fraction is not zero. If the exponent- 
underflow mask bit is one, the operation 
is completed by making the charactei — 
istic 128 greater than the correct 
value, and a program interruption for 
exponent underflow occurs. The result 
is normalized, and the sign and fraction 
remain correct. If the exponent- 
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underflow mask bit is zero* program 
interruption does not take place; 
instead, the operation is completed by 
making the product a true zero. For 
extended results, exponent underflow is 
not recognized when the low-order chai — 
acteristic would be less than zero but 
the high-order characteristic is equal 
to or greater than zero. 

Exponent underflow does not occur when 
the characteristic of an operand becomes 
less than zero during normalization of 
the operands, as long as the final prod- 
uct can be represented wi th the correct 
characteri stic. 

When either or both operand fractions 
are zero, the result is made a true 
zero, and no exponent overflow or expo- 
nent underflow occurs. 



STD R t ,D 2 (X 9 ,B 3 ) [RX, Long Operands] 



'60' 


Ri 


x a 


B a 


D a 



8 12 16 20 



31 



The first operand is placed unchanged at 
the second-operand location. 

The Rt field must designate register 0, 
2, 4, or 6; otherwise, a specification 
exception is recognized. 

Condi ti on Code ! The code remains 
unchanged. 

Program Exceptions ? 

Access (store, operand 2) 
Speci f icati on 



The sign of the product is determined by 
the rules of algebra, except that the 
sign is always zero when the result is 
made a true zero. 

The R, field for MER, ME, MDR, and MD, 
and the R a field for MER, MDR, and MXDR 
must designate register 0, 2, 4, or 6. 
The R, field for MXDR, MXD, and MXR, and 
the R a field for MXR must designate 
register or 4. Otherwise, a specifi- 
cation exception is recognized. 



SUBTRACT NORMALIZED 



5 £K K i , K 2 



[RR, Short Operands] 



'3B' 


Ri 


R a 



12 15 



Condi ti on 
unchanged. 



Code : The code remains SE R 1 ,D a (X a ,B a ) CRX, Short Operands] 



Program Excepti ons : 

Access (fetch, operand 2 cf ME, MD, 

and MXD only) 
Exponent overflow 
Exponent underflow 
Speci f i cation 



Programming Notes 



'7B' 


Ri 


X a 


B a 


D a 



8 12 16 20 



31 



SDR Rt,R a 



[RR, Long Operands] 



'2B' 


R, 


R a 



8 12 15 



An example of the use of the MULTI- 
PLY instruction is given in Appen- 
dix A. 

Interchanging the two operands in a 

floating-point multiplication does 

not affect the value of the 
product. 



SD R,,D a (X a ,B 2 ) CRX, Long Operands] 



'6B» 


R, 


x a 


B a 


D a 



8 12 16 20 



SXK K i , K j 



31 



[RR, Extended Operands] 



STORE 



STE R,,D a (X a ,B a ) [RX, Short Operands] 



'70' 


Ri 


x a 


B a 


D a 



8 12 16 20 



31 



'37' 


Ri 


R 2 



8 



12 15 



The second operand is subtracted from 
the first operand, and the normalized 
difference is placed at the first- 
operand location. 

The execution of SUBTRACT NORMALIZED is 
identical to that of ADD NORMALIZED, 
except that the second operand parti c- 
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i pates in the operation with its sign 
bit inverted. 

The R, field of SER, SE, SDR, and SD, 
and the R a field of SER and SDR must 
designate register 0, 2, 4, or 6. The 
R, and R 2 fields of SXR must designate 
register or 4. Otherwise, a specifi- 
cation exception is recognized. 

Resulti ng Condi ti on Code ? 



Result fraction zero 
Result less than zero 
Result greater than zero 



Program Exceptions : 

Access (fetch, operand 2 of SE and 

SD only) 
Exponent overflow 
Exponent underflow 
Si gni f icance 
Speci f i cation 



SUBTRACT UNNORMALIZED 



SUR R,,R a 



[RR, Short Operands] 



»3F ? 


Ri 


R» 



8 12 15 



SU R,,D a (X a ,B a ) [RX, Short Operands] 



t 7F l 


Ri 


x a 


B a 


D a 



8 12 16 20 



SWR R,,R a 



[RR, Long Operands] 



i 2 F» 


Ri 


R a 



SUi 



8 12 15 



Ri,D a (X a ,B a ) [RX, Long Operands] 



f 6F f 


R, 


x a 


B a 


D a 



8 



12 16 



20 



31 



The second operand is subtracted from 

the first operand, and the unnormalized 

difference is placed at the first- 
operand location. 

The execution of SUBTRACT UNNORMALIZED 
is identical to that of ADD 
UNNORMALIZED, except that the second 
operand participates in the operation 
with its sign bit inverted. 

The Rj and R a fields must designate 
register 0, 2, 4, or 6; otherwise, a 
specification exception is recognized. 

Resulting Condi tion Code ? 



Result fraction zero 
Result less than z&ro 
Result greater than zero 



31 



Program Exceptions : 

Access (fetch, operand 2 of SU and 

SU only) 
Exponent overflow 
Signi f icance 
Speci f ication 
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CHAPTER 10. CONTROL INSTRUCTIONS 



DIAGNOSE 10-4 

EXTRACT PRIMARY ASN 10-5 

EXTRACT SECONDARY ASN 10-5 

INSERT ADDRESS SPACE CONTROL 10-6 

INSERT PSW KEY 10-7 

INSERT STORAGE KEY EXTENDED 10-7 

INSERT VIRTUAL STORAGE KEY 10-7 

INVALIDATE PAGE TABLE ENTRY 10-8 

LOAD ADDRESS SPACE PARAMETERS 10-10 

LOAD CONTROL . 10-17 

LOAD PSW 10-17 

LOAD REAL ADDRESS 10-18 

MOVE TO PRIMARY 10-19 

MOVE TO SECONDARY 10-19 

MOVE WITH KEY 10-20 

PROGRAM CALL 10-21 

PROGRAM TRANSFER 10-28 

PURGE TLB 10-33 

RESET REFERENCE BIT EXTENDED 10-33 

SET ADDRESS SPACE CONTROL 10-33 

SET CLOCK 10-34 

SET CLOCK COMPARATOR 10-35 

SET CPU TIMER 10-35 

SET PREFIX 10-36 

SET PSW KEY FROM ADDRESS 10-36 

SET SECONDARY ASN 10-37 

SET STORAGE KEY EXTENDED 10-40 

SET SYSTEM MASK 10-40 

SIGNAL PROCESSOR 10-40 

STORE CLOCK COMPARATOR 10-42 

STORE CONTROL 10-42 

STORE CPU ADDRESS 10-42 

STORE CPU ID 10-42 

STORE CPU TIMER 10-43 

STORE PREFIX 10-43 

STORE THEN AND SYSTEM MASK 10-44 

STORE THEN OR SYSTEM MASK 10-44 

TEST BLOCK 10-44 

TEST PROTECTION 10-46 

TRACE 10-48 



This chapter includes all privileged and 
semipri vi leged instructions described in 
this publication, except the 
input/output instructions, which are 
described in Chapter 14, "I/O 
Instructi ons." 

Privileged instructions may be executed 
only when the CPU is in the supervisor 
state. An attempt to execute a privi- 
leged instruction in the problem state 
generates a privileged-operation excep- 
ti on. 



The sem 
those ins 
in the 
authori ty 
attempt 
instructi 
the autho 
generates 
tion or s 



iprivileged in 
tructions that 

problem state 

requi rements 

to execute a 

on in the pro 

rity requi reme 

a pri vi leged- 
ome other prog 



structions are 

can be executed 

when certain 

are met. An 

semi pri vi leged 

blem state when 

nts are not met 

operation excep- 

ram-i nterrupti on 



condition depending on the particular 
requirement which is violated. Those 
requirements which cause a privileged- 
operation exception to be generated in 
the problem state are not enforced when 
execution is attempted in the supervisor 
state. 

The control instructions and their 
mnemonics, formats, and operation codes 
are listed in the figure "Summary of 
Control Instructions." The figure also 
indicates when the condition code is set 
and the exceptional conditions in opei — 
and designations, data, or results that 
cause a program interruption. 

For those control instructions which 
have special rules regarding the handl- 
ing of exceptional situations, a section 
called "Special Conditions" is included. 
This section indicates the type of 
ending (suppression, nullification, or 
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completion) only for those exceptions 
for which the ending may vary. 

Note : In the detailed descriptions of 
the individual instructions* the mnemon- 
ic and the symbolic operand designation 
for the assembler language are shown 
with each instruction. For LOAD PSW, 
for example, LPSW is the mnemonic and 
D 2 (B 3 ) the operand designation. 



Programming Note 



The control instructions in the 370-XA 
mode differ from those offered in the 



System/370 mode in 
instructions* which 
as standard or as 
System/370 mode, are 
370-XA mode: 



that the following 

are offered either 

optional in the 

not offered in the 



CONNECT CHANNEL SET 
DISCONNECT CHANNEL SET 
INSERT STORAGE KEY 
READ DIRECT 
RESET REFERENCE BIT 
SET STORAGE KEY 
WRITE DIRECT 

The following additional instruction is 
available only in the 370-XA mode: 

TRACE 
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Name 


Mne- 
moni c 


Character! st i cs 


Op 
Code 


DIAGNOSE 

EXTRACT PRIMARY ASN 
EXTRACT SECONDARY ASN 
INSERT ADDRESS SPACE CONTROL 
INSERT PSW KEY 


EPAR 
ESAR 
IAC 
IPK 


DM 
RRE 
RRE 
RRE C 
S 


P DM 

Q 

Q 

Q 

Q 


SO 
SO 
SO 

G2 


R 
R 
R 
R 


83 

B226 

B227 

B224 

B20B 


INSERT STORAGE KEY EXTENDED 
INSERT VIRTUAL STORAGE KEY 
INVALIDATE PAGE TABLE ENTRY 
LOAD ADDRESS SPACE PARAMETERS 
LOAD CONTROL 


ISKE 
IVSK 
IPTE 
LASP 
LCTL 


RRE 
RRE 
RRE 
SSE C 
RS 


P 

Q A 1 
P A 1 
P AS SP 
P A SP 


SO 

$ 
SO 


R 


B229 
B223 
B221 
E500 
B7 


LOAD PSW 

LOAD REAL ADDRESS 
MOVE TO PRIMARY 
MOVE TO SECONDARY 
MOVE WITH KEY 


LPSW 

LRA 

*1VCP 

MVCS 

MVCK 


S L 
RX C 
SS C 
SS C 
SS C 


P A SP 
P A 1 
Q A 
Q A 
Q A 


SO « 
SO * 


R 
ST 
ST 
ST 


82 

Bl 
DA 
DB 
D9 


PROGRAM CALL 

PROGRAM TRANSFER 

PURGE TLB 

RESET REFERENCE BIT EXTENDED 

SET ADDRESS SPACE CONTROL 


PC 

PT 

PTLB 

RRBE 

SAC 


S 

RRE 
S 

RRE C 
S 


Q AT 
Q AT SP 
P 
P A 1 

SP 


Z 1 T $ GM 
Z* T $ 
$ 

SO * 


B R 
B 


B218 
B228 
B20D 
B22A 
B219 


SET CLOCK 

SET CLOCK COMPARATOR 

SET CPU TIMER 

SET PREFIX 

SET PSW KEY FROM ADDRESS 


SCK 

SCKC 

SPT 

SPX 

SPKA 


S C 

S 

S 

S 

S 


P A SP 
P A SP 
P A SP 
P A SP 
Q 


$ 




B204 
B206 
B208 
B210 
B20A 


SET SECONDARY ASN 

SET STORAGE KEY EXTENDED 

SET SYSTEM MASK 

SIGNAL PROCESSOR 

STORE CLOCK COMPARATOR 


SSAR 

SSKE 

SSM 

SIGP 

STCKC 


RRE 

RRE 

5 

RS C 

S 


AT 
P 

P A SP 
P 
P A SP 


Z 3 T « 
* 

SO 

$ 


R 
ST 


B225 

B22B 

80 

AE 

B207 


STORE CONTROL 
STORE CPU ADDRESS 
STORE CPU ID 
STORE CPU TIMER 
STORE PREFIX 


STCTL 

STAP 

STIDP 

STPT 

STPX 


RS 

S 

S 

S 

S 


P A SP 
P A SP 
P A SP 
P A SP 
P A SP 




ST 
ST 
ST 
ST 
ST 


B6 

B212 

B202 

B209 

B211 


STORE THEN AND SYSTEM MASK 
STORE THEN OR SYSTEM MASK 
TEST BLOCK 
TEST PROTECTION 
TRACE 


STNSM 

STOSM 

TB 

TPROT 

TRACE 


SI 
SI 

RRE C 
SSE C 
RS 


P A 

P A SP 

P A 1 

P A 1 

P A SP 


II $ GO 
T « 


ST 
ST 
R 


AC 

AD 

B22C 

E501 

99 



Summary of Control Instructions (Part 1 of 2) 
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includes 


the 


impl ied 


use 


of 


general 


register 0. 


i ncludes 


the 


impl ied 


use 


of 


general 


register 2. 


i ncludes 


the 


impl ied 


use 


of 


general 


regi sters 



Explanation : 

* Causes serialization and checkpoint synchronization. 

$ Causes serialization. 

A Access exceptions for logical addresses. 

A 1 Access exceptions; not all access exceptions may occur; see instruc- 
tion description for details. 

AS Access exceptions and ASN-translati on-specifi cation exception; see 
instruction description for details. 

AT ASN-translation exceptions (which include addressing, ASN-translation 
specification, AFX translation, and A5X translation). 

B PER branch event. 

C Condition code is set. 

DM Depending on the model, DIAGNOSE may generate various program excep- 
tions and may change the condition code. 

GO Instruction execution 

G2 Instruction execution 

GM Instruction execution 
3, 4, and 14. 

II Interrupti ble instruction. 

L New condition code is loaded. 

P Privileged-operation exception. 

Q Privileged-operation exception for 

R PER general-register-alteration event. 

RRE RRE instruction format. 

RS RS instruction format. 

RX RX instruction format. 

S S instruction format. 

SI SI instruction format. 

SO Special-operation exception. 

SP Specification exception. 

SS SS instruction format. 

SSE SSE instruction format. 

ST PER storage-alteration event. 

T Trace exceptions (which include trace table, addressing, and low- 
address protection). 

Z 1 Additional exceptions and events for PROGRAM CALL (which include 

addressing, EX-translati on, LX-translati on, PC-translation-specifi- 
cation, and special-operation exceptions and space-switch event). 

Z 2 Additional exceptions and events for PROGRAM TRANSFER (which include 
addressing, primary-authority, and special-operation exceptions and 
space-switch event). 

Z 3 Additional exceptions for SET SECONDARY ASN (which include addressing, 
secondary authority, and special operation). 



semipri vi leged instructions. 



Summary of Control Instructions (Part 2 of 2) 



DIAGNOSE 



fy the particular diagnostic 
The use depends on the model. 



function. 



'83' 





8 



The CPU performs bu 
functions, or other 
functions. The purpos 
tic functions is to v 
tioning of equipment 
faulty components, 
dependent functions 
disabling of failing 
uration of CPUs, sto 
paths, and modificatio 
age. 



31 

ilt-in diagnostic 
model -dependent 
e of the diagnos- 
erify proper func- 
and to locate 
Other model- 
may include 
buffers, reconfig- 
rage, and channel 
n of control stoi — 



The execution of the instruction may 
affect the state of the CPU and the 
contents of a register or storage 
location, as well as the progress of an 
I/O operation. Some diagnostic func- 
tions may cause the test indicator to be 
turned on. 



Condi ti on Code : 
able. 



The code is unpredict- 



Program Exceptions : 

Privileged operation 
Depending on the model, other 
exceptions may be recognized. 



Bits 8-31 may be used as in the SI or RS 
formats, or in some other way, to speci- 
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Programming Notes 



extracti on-authori ty-control bit is not 
examined. 



Since the instruction is not 
intended for problem-state-program 
or control-program use* DIAGNOSE 
has no mnemonic. 

DIAGNOSE, unlike other 
instructions, does not follow the 
rule that programming errors are 
distinguished from equipment 
errors. Improper use of DIAGNOSE 
may result in false machine-check 
indications or may cause actual 
machine malfunctions to be ignored. 
It may also alter other aspects of 
system operation, including 
instruction execution and channel- 
program operation, to an extent 
that the operation does not comply 
with that specified in this publi- 
cation. As a result of the 
improper use of DIAGNOSE, the 
system may be left in such a condi- 
tion that the power-on reset or 
initial-mi croprogram-loadi ng (IML) 
function must be performed. Since 
the function performed by DIAGNOSE 
may differ from model to model and 
between versions of a model, the 
program should avoid issuing DIAG- 
NOSE unless the program recognizes 
both the model number and version 
code stored by STORE CPU ID. 



The priority of recognition of program 
exceptions for the instruction is shown 
in the figure "Priority of Execution: 
EXTRACT PRIMARY ASN." 



Condi ti on 
unchanged, 



Code: 



The code remains 



Program Except i ons : 



Privileged operation (extraction- 
authority control is zero in 
the problem state) 

Special operation 



1.-6. Exceptions with the same pri- 
ority as the priority of pro- 
gram-interruption conditions 
for the general case. 

7. A Access exceptions for second 
instruction halfword. 

7.B Special-operation exception 
due to DAT being off. 

8. Privileged-operation exception 
due to extraction-authority 
control, bit 4 of control reg- 
ister 0, being zero. 



EXTRACT PRIMARY ASN 



Priority of Execution: 
PRIMARY ASN 



EXTRACT 



EPAR 



Ri 



tRRE] 



B226 



//////// R t //// 



16 



24 



28 31 



The 16-bit PASN, bits 16-31 of control 
register 4, is placed in bit positions 
16-31 of general register R,. Bits 0-15 
of the general register are set to 
zeros. 



EXTRACT SECONDARY ASN 



ESAR R, 



[RRE] 



'B227' 


//////// 


R, 


//// 



16 



24 



28 31 



Bits 16-23 and 28-31 of the instruction 
are ignored. 



Special Conditions 



The instruction must be executed with 
DAT on; otherwise, a special-operation 
exception is recognized. The special- 
operation exception is recognized in 
both the problem and supervisor states. 

In the problem state, the extraction- 
authority control, bit 4 of control 
register 0, must be one; otherwise, a 
privileged-operation exception is recog- 
nized. In the supervisor state, the 



The 16-bit SASN, bits 16-31 of control 
register 3, is placed in bit positions 
16-31 of general register R, . Bits 0-15 
of the general register are set to 
zeros. 



Bits 16-23 and 28 
are ignored. 



•31 of the instruction 



Special Conditions 



The instruction must be executed with 
DAT on; otherwise, a special-operation 
exception is recognized. The special- 
operation exception is recognized in 
both the problem and supervisor states. 
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In the problem state, the extraction- 
authority control, bit 4 of control 
register 0, must be one; otherwise, a 
privileged-operation exception is recog- 
nized. In the supervisor state, the 
extraction-authority-control bit is not 
exami ned. 

The priority of recognition of program 
exceptions for the instruction is shown 
in the figure "Priority of Execution: 
EXTRACT SECONDARY ASN." 



Condi tion 
unchanged. 



Code: 



The code remains 



Program Except i ons : 



Privileged operation (extraction- 
authority control is zero in 
the problem state) 

Special operation 



1.-6. Exceptions with the same pri- 
ority as the priority of pro- 
gram-interruption conditions 
for the general case. 

7. A Access exceptions for second 
instruction halfword. 

7.B Special-operation exception 
due to DAT being off. 

8. Privileged-operation exception 
due to extraction-authority 
control, bit 4 of control 
register 0, being zero. 



Priority of Execution: EXTRACT 
SECONDARY ASN 



INSERT ADDRESS SPACE CONTROL 



IAC R, 



CRRE] 



»B224» 


//////// 


R, 


//// 



Special Conditions 



The instruction must be executed with 
DAT on; otherwise, a special-operation 
exception is recognized. The special- 
operation exception is recognized in 
both the problem and supervisor states. 

In the problem state, the extraction- 
authority control, bit 4 of control 
register 0, must be one; otherwise, a 
privileged-operation exception is recog- 
nized. In the supervisor state, the 
extraction-authority-control bit is not 
exami ned. 

The priority of recognition of program 
exceptions for the instruction is shown 
in the figure "Priority of Execution: 
INSERT ADDRESS SPACE CONTROL." 

Resulting Condi ti on Code : 



PSW bit 16 zero 
PSW bit 16 one 



Program Excepti ons : 

Privileged operation (extraction- 
authority control is zero in 
the problem state) 

Special operation 



1.-6. Exceptions with the same pri- 
ority as the priority of pro- 
gram-interruption conditions 
for the general case. 

7. A Access exceptions for second 
instruction halfword. 

7.B Special-operation exception 
due to DAT being off. 

8. Privileged-operation exception 
due to extraction-authority 
control, bit 4 of control 
register 0, being zero. 



16 



24 



28 31 



Priority of Execution: 
SPACE CONTROL 



INSERT ADDRESS 



The address-space-control bit, bit 16 of 
the current PSW, is placed in bit posi- 
tion 23 of general register R t . Bits 
16-22 of the register are set to zeros, 
and bits 0-15 and 24-31 of the register 
remain unchanged. The address-space- 
control bit is also used to set the 
condition code. 



Bits 16-23 and 
are ignored. 



28-31 of the instruction 



Programming Notes 



1. Bits 16-22 of general register Ri 
are reserved for expansion for use 
with possible future facilities. 
The program should not depend on 
these bits being set to zeros. 
Similarly, condition codes 2 and 3 
may be set as a result of future 
faci li ti es. 
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2. INSERT A 
SET ADDR 
def i ned 
byte of a 
the addr 
be saved 
ter as th 
i n the 
regi ster 



DDRESS SPACE CONTROL and 
ESS SPACE CONTROL are 
to operate on the third 
general register so that 
ess-space-control bit can 
in the same general regi s- 
e PSW key, which is placed 
fourth byte of general 
2 by INSERT PSW KEY. 



INSERT PSW KEY 



IPK 



[S] 



'B20B' 


//////////////// 



16 



31 



In the 24-bit addressing mode, bits 8-19 
of general register R a designate a 
4K-byte block in real storage, and bits 
0-7 and 20-31 of the register are 
ignored. In the 31-bit addressing mode, 
bits 1-19 of general register R 2 desig- 
nate a 4K-byte block in real storage, 
and bits and 20-31 of the register are 
i gnored. 

The address designating the storage 
block, being a real address, is not 
subject to dynamic address translation. 
The reference to the storage key is not 
subject to a protection exception. 

The seven-bit storage key is inserted in 
bit positions 24-30 of general register 
Ri, and bit 31 is set to zero. The 
contents of bit positions 0-23 of the 
register remain unchanged. 



The four-bit PSW-key, bits 8-11 of the 
current PSW, is inserted in bit posi- 
tions 24-27 of general register 2, and 
bits 28-31 of that register are set to 
zeros. Bits 0-23 of general register 2 
remain unchanged. 



Bits 16-31 
i gnored. 



of the instruction are 



Condi ti on 
unchanged 



Code 



The code 



remai ns 



Program Excepti ons : 

Addressing (address 

general register 

Privileged operation 



speci f i ed 
R a ) 



by 



Special Condi ti ons 



In the problem state, the extraction- 
authority control, bit 4 of control 
register 0, must be one; otherwise, a 
privileged-operation exception is recog- 
nized. In the supervisor state, the 
extraction-authority-control bit is not 
exami ned. 



Condi ti on 
unchanged. 



Code: 



The code 



remai ns 



INSERT VIRTUAL STORAGE KEY 



IVSK 



R i * R i 



CRRE] 



'B223* 


//////// 


Ri 


R a 



16 



24 



28 31 



The storage key for the location desig- 
nated by the virtual address in general 
register R a is inserted in general 
regi ster Ri . 



Program Excepti ons : 

Privileged operation (extraction- 
authority control is zero in 
the problem state) 



INSERT STORAGE KEY EXTENDED 



ISKE 



R 1 , Rr 



[RRE] 



»B229 f 


//////// 


R, 


R 2 



16 



24 



28 31 



The storage key for the block that is 

addressed by the contents of general 

register R 2 is inserted in general 
regi ster R t . 



Bits 16-23 
i gnored. 



of the instruction are 



Bits 16-23 
i gnored. 



of the instruction are 



Selected bits of general register R 2 are 
used as a virtual address. In the 
24-bit addressing mode, the address is 
designated by bits 8-31 of the register, 
and bits 0-7 are ignored. In the 31-bit 
addressing mode, the address is desig- 
nated by bits 1-31, and bit is 
i gnored. 



The address i 
subject to 
bit, bit 16 o 
primary-space 
treated as a 
the secondary 
treated as a 
The reference 
subject to a 



s a virtual address and is 
the address-space-control 

f the current PSW. In the 
mode, the address is 

primary virtual address; in 

-space mode, the address is 
secondary virtual address, 
to the storage key i s not 

protection exception. 



Bits 0-4 of the storage key, which are 
the access-control bits and the fetch- 
protection bit, are placed in bit posi- 
tions 24-28 of general register R,, with 
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bits 29-31 set to zeros. The contents 
of bit positions 0-23 of the register 
remain unchanged. The change and refei — 
ence bits in the storage key are not 
inspected. The change bit is not 
affected by the operation. The refei — 
ence bit* depending on the model* may or 
may not be set to one as a result of the 
operati on. 

The following diagram shows the storage 
key and the register positions just 
descri bed. 

Storage Key 
for the 
Locati on 



ACC 


F 


R 


C 



Zeros 



1 * 



Ri 





ACC 


F 


000 



24 28 



31 



1.-6. Exceptions with the same pri- 
ority as the priority of pro- 
gram-interruption conditions 
for the general case. 

7. A Access exceptions for second 
instruction halfword. 

7.B Special-operation exception due 
to DAT being off. 

8. Privileged-operation exception 
due to extraction-authority 
control* bit 4 of control reg- 
ister 0* being zero. 

9. Access exceptions (except for 
protection) for address speci- 
fied by general register R a . 



Priority of Execution: 
STORAGE KEY 



Programming Note 



INSERT VIRTUAL 



Special Conditions 



The instruction must be executed with 
DAT on; otherwise* a special-operation 
exception is recognized. The special- 
operation exception is recognized in 
both the problem and supervisor states. 

In the problem state* the extraction- 
authority control, bit 4 of control 
register 0* must be one* otherwise* a 
privileged-operation exception is recog- 
nized. In the supervisor state, the 
extraction-authority-control bit is not 
examined. 

The priority of recognition of program 
exceptions for the instruction is shown 
in the figure '-Priority of Execution: 
INSERT VIRTUAL STORAGE KEY." 



Condi tion 
unchanged. 



Code: 



The code 



remains 



Program Except i ons : 

Access (except for 
address specified 
register R a ) 

Privileged operation 
authority control 
the problem state) 

Special operation 



protecti on, 
by general 

(extracti on- 
is zero in 



Since all bytes in a 4K-byte block are 
associated with the same page and the 
same storage key, bits 20-31 of general 
register R a essentially are ignored. 



INVALIDATE PAGE TABLE ENTRY 



IPTE R,,R. 



CRRE3 



'8221' 


//////// 


Ri 


R 8 



16 



24 



28 31 



The designated page-table entry is 
invalidated, and the translation- 
lookaside buffers (TLBs) in all CPUs in 
the configuration are cleared of the 
associated entries. 



Bits 16-23 
ignored. 



of the instruction are 



The contents of general register Ri have 
the format of a segment-table entry with 
only the page-table origin used. The 
contents of general register R 2 have the 
format of a virtual address with only 
the page index used. The contents of 
fields that are not part of the page- 
table origin or page index are ignored. 

The contents of the general registers 
just described are as follows: 
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R, 



/ 


Page-Table Origin 


////// 



26 



31 



//////////// 


PX 


//////////// 



12 



20 



31 



have been cleared from the TLB on this 
CPU and (2) all other CPUs in the 
configuration have completed any storage 
accesses, including the updating of the 
change and reference bits, by using TLB 
entries corresponding to the specified 
parameters. 



The page-table origin and the page index 
designate a page-table entry, following 
the dynamic-address-translation rules 
for page-table lookup. The page-table 
origin is treated as a 31-bit address, 
and the addition is performed by using 
the rules for 31-bit address arithmetic, 
regardless of the setting of the 
addressing mode, which is specified by 
bit 32 of the current PSW. Carries into 
bit position as a result of the addi- 
tion of the page index and page-table 
origin are ignored. The address formed 
from these two components i s a real 
address. The page-invalid bit of this 
page-table entry is set to one. During 
this procedure, no page-table-length 
check is made, and the page-table entry 
is not inspected for availability or 
format errors. Additionally, the page- 
frame real address contained in the 
entry is not checked for an addressing 
exception. 

The entire page-table entry is fetched 
concurrently from storage. Subsequently 
the byte containing the page-invalid bit 
is stored. The fetch access to the 
page-table entry is subject to key- 
controlled protection, and the store 
access is subject to key-controlled 
protection and low-address protection. 

A serialization function is performed 
before the operation begins and again 
after the operation is completed. As is 
the case for all serialization oper- 
ations, this serialization applies only 
to this CPU; other CPUs are not neces- 
sarily serialized. 

If it is successful in setting the 
page-invalid bit to one, this CPU clears 
selected entries from its TLB and 
signals all CPUs in the configuration to 
clear selected entries from their TLBs. 
Each TLB is cleared of at least those 
entries that have been formed using all 
of the following: 

• The page-table origin designated by 
the first operand 



The page index 
second operand 



designated by the 



• The page-frame real address 
contained in the designated page- 
table entry 

The execution of INVALIDATE PAGE TABLE 
ENTRY is not completed on the CPU which 
executes it until (1) all entries corre- 
sponding to the specified parameters 



Special Condi tions 



When bit positions 8-12 of control 
register contain an invalid code, a 
translation-specification exception is 
recognized. The exception is recognized 
regardless of whether DAT is on or off. 

The operation is suppressed on all 
addressing and protection exceptions. 



Condi tion 
unchanged. 



Code: 



The code 



remai ns 



Program Exceptions : 

Addressing (page-table entry) 

Privileged operation 

Protection (fetch and store, page- 
table entry, key-controlled 
protection, and low-address 
protecti on) 

Translation specification (bits 
8-12 in control register 
only) 



Programming Notes 



The selective clearing of entries 
may be implemented in different 
ways, depending on the model, and, 
in general, more entries may be 
cleared than the minimum number 
required. Some models may clear 
all entries which contain the 
designated page-frame real address. 
Others may clear all entries which 
contain the designated page index, 
and some implementations may clear 
precisely the minimum number of 
entries required. Therefore, in 
order for a program to operate on 
all models, the program should not 
take advantage of any properties 
obtained by a less selective cleat — 
i ng on a particular model. 



The clearin 
make use o 
address in 
Therefore, i 
when in the 
contained a 
that is diff 
value, copi 
values may r 



g of TLB entries may 
f the page-frame real 
the page-table entry, 
f the page-table entry, 
attached state, ever 
page-frame real address 
erent from the current 
es of the previous 
emain in the TLB. 



3. 



INVALIDATE PAGE TABLE ENTRY cannot 
be safely used to update a shared 
location in main storage if the 
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4. 



possibility exists that another CPU 
or a channel program may also be 
updating the location. 

The address of the page-table entry 
for INVALIDATE PAGE TABLE ENTRY is 
a 31-bit real address, and the 
address arithmetic is performed by 
following the normal rules for 
31-bit address arithmetic with 
wraparound at 2 31 - 1. Contrast 
this with implicit translation and 
the translation for LOAD REAL 
ADDRESS, both of which, depending 
on the model, may treat addresses 
of DAT-table entries as either real 
or absolute and may result either 
in wraparound or in an addressing 



exception when a 
bi t posi ti on . 
DAT tables should 
to wrap from 



carry occurs into 

Accordingly, the 

not be specified 

maximum storage 



locations to location and should 
not be placed at storage locations 
whose real and absolute addresses 
are different. 



LOAD ADDRESS SPACE PARAMETERS 



LASP D,(Bt),D a (B a ) 



ESSE] 



E500 



B, 



D, 
-/— 



~/ 1 



16 20 



32 36 47 



The contents of the doubleword at the 
first-operand location contain values to 
be loaded into control registers 3 and 
4, including a secondary ASN and a 
primary ASN. Execution of the instruc- 
tion consists in performing four major 
steps: PASN translation, SASN trans- 
lation, SASN authorization, and 
control-register loading. Each of these 
steps may or may not be performed, 
depending on the outcome of certain 
tests and on the setting of bits 29-31 
of the second-operand address. These 
steps, when successful, obtain addi- 
tional values, which are loaded into 
control registers 1, 5, and 7. When the 
steps are not successful, no control 
regi sters are changed, and the reason i s 
indicated in the condition code. 



The doubleword first 
PSW-key mask (PKM), 
(SASN), an authorizat 
a primary ASN (PASN) 
is translated by m 
translation tables 
LTD, and, optional 
secondary ASN is tran 
the ASN-translati on t 
SSTD, and, optional 
check is made to ensu 
is authorized to esta 



operand contains a 
a secondary ASN 
ion index (AX), and 
The primary ASN 
eans of the ASN- 
to obtain a PSTD, 
ly, an AX. The 
slated by means of 
ables to obtain an 
ly, an authority 
re that the new AX 
blish the new SASN. 



PKM-d 


SASN-d 


AX-d 


PASN-d 



16 

The "d" stands 
and is used to 
from other f 
which are refe 
The current co 
ing fields in 
referred to a 
The updated 
registers are 
SASN-new, etc. 



32 



48 



for designated doubl 
distinguish these f 
ields with similar 
rred to in the defini 
ntents of the corres 
the control regi ster 
s PKM-old, SASN-old, 
contents of the co 

referred to as PKM 



63 

eword 
i elds 
names 
t i on. 
pond- 
s are 
etc. 
ntrol 
-new, 



The second-operand address is not used 
to address data; instead, the rightmost 
three bits are used to control portions 
of the operation. The remainder of the 
second-operand address is ignored. Bits 
29-31 of the second-operand address are 
used as follows: 



Bit 


Function Specified 
in Second Operand 


When Bit Is Zero 


When Bit Is One 


29 


ASN translation 
performed only 
when new ASN and 
old ASN are dif- 
ferent. 


ASN translation 
performed. * 


30 


Use AX associ- 
ated with PASN. 


Use AX from 
first operand. 


31 


SASN authoriza- 
tion performed. * 


SASN authoriza- 
tion not pel — 
formed. 


* SASN translation and SASN authori- 
zation are performed only when 
SASN-d is not equal to PASN-d. 
When SASN-d is equal to PASN-d, 
the SSTD is loaded from the PSTD, 
and no authorization is performed. 



The doubleword at the first-operand 
location has the following format: 



The operation of LOAD ADDRESS SPACE 
PARAMETERS is depicted in the figure 
"Execution of LOAD ADDRESS SPACE PARAME- 
TERS." 



PASN Translation 



In the PASN translation process, the 
PASN-d is translated by means of the ASN 
first table and the ASN second table. 
The STD and LTD fields and, optionally, 
the AX field, obtained from the ASN- 
second-table entry are subsequently used 
to update the corresponding control 
regi sters. 

When bit 29 of the second-operand 
address is one, PASN translation is 
always performed. When bit 29 is zero, 
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PASN translation is performed only when 
PASN-d is not equal to PASN-old. When 
bit 29 is zero and PASN-d is equal to 
PASN-old, the PSTD-old and LTD-old are 
left unchanged in the control registers 
and become the PSTD-new and LTD-new, 
respectively. In this case, if bit 30 
is zero, then the AX-old is left 
unchanged in the control register and 
becomes the AX-new. 



The contents of the STD, ATO, and ATL 
fields in the ASN-second-table entry 
which is accessed as a result of the 
SASN translation are referred to as 
STD-s, ATO-s, and ATL-s, respectively. 



SASN Authori zati on 



The PASN translation follows the normal 
rules for ASN translation, except that 
the invalid bits, bit in the ASN- 
first-table entry and bit in the ASN- 
second-table entry, when ones, do not 
result in an ASN-translati on exception, 
and the space-switch-event-control bit 
in the ASN-second-table entry, when one, 
does not result in a space-switch event. 
When either of the invalid bits is one, 
condition code 1 is set. When the ASN- 
second-table entry is valid and either 
the current space-switch-event-control 
bit in control register 1 is one or the 
space-switch-event-control bit in the 
ASN-second-table entry is one, condition 
code 3 is set. When condition code 1 or 
3 is set, the control registers remain 
unchanged. 

The contents of the AX, STD, and LTD 
fields in the ASN-second-table entry 
which is accessed as a result of the 
PASN translation are referred to as 
AX-p, STD-p, and LTD-p, respectively. 



SASN Translation 



In the SASN-translation process, the 
SASN-d is translated by means of the ASN 
first table and the ASN second table. 
The STD field obtained from the ASN- 
second-table entry is subsequently used 
to update the secondary-segment-table 
designation (SSTD) in control register 
7. The ATO and ATL fields obtained are 
used in the SASN authorization, if it 
occurs. 

SASN translation is performed only when 
SASN-d is not equal to PASN-d. When 
SASN-d is equal to PASN-d, the SSTD-new 
is set to the same value as PSTD-new. 
When SASN-d is equal to SASN-old, bit 29 
(force ASN translation) is zero, and bit 
31 (skip SASN authorization) is one, 
then SASN translation is not performed, 
and SSTD-old becomes SSTD-new. 

The SASN translation follows the normal 
rules for ASN translation, except that 
the invalid bits, bit in the ASN- 
first-table entry and bit in the ASN- 
second-table entry, when ones, do not 
result in an ASN-translati on exception. 
When either or both of the invalid bits 
are ones, condition code 2 is set, and 
the control registers remain unchanged. 



SASN authorization is performed when bit 
31 of the second-operand address i s zero 
and SASN-d is not equal to PASN-d. When 
SASN-d is equal to PASN-d or when bit 31 
of the second-operand address is one, 
SASN authorization is not performed. 

SASN authorization is performed by using 
ATO-s, ATL-s, and the intended value for 
AX-new. When bit 30 of the second- 
operand address is zero and PASN trans- 
lation was performed, the intended value 
for AX-new is AX-p. When bit 30 of that 
address is zero and PASN translation was 
not performed, the AX is not changed, 
and AX-new is the same as AX-old. When 
bit 30 of that address is one, the 
intended value for AX-new is AX-d. SASN 
authorization follows the rules for 
secondary authorization as described in 
the section "ASN-Authori zati on Process" 
in Chapter 3, "Storage." If the SASN is 
not authorized (that is, the authority- 
table length is exceeded, or the 
selected bit is zero), condition code 2 
is set, and none of the control regis- 
ters are updated. 



Control-Regi ster Loading 



When the PASN-translati on, SASN- 
translation, and SASN-authori zati on 
functions, if called for in the opera- 
tion, are performed without encountering 
any exceptions, the operation is 
completed by replacing the contents of 
control registers 1, 3, 4, 5, and 7 with 
the new values, and condition code is 
set. The control registers are loaded 
as follows: 

The PSW-key-mask and SASN fields in 

control register 3 are replaced by the 

PKM-d and SASN-d fields from the first- 
operand location. 

The PASN, bits 16-31 of control register 
4, is replaced by the PASN-d field from 
the first-operand location. 

The authorization index, bits 0-15 of 
control register 4, is replaced as 
follows: 

• When bit 30 of the second-operand 
address is one, from AX-d. 

• When bit 30 of the second-operand 
address is zero and PASN trans- 
lation is performed, from AX-p. 
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• When bit 30 of the second-operand 
address is zero and PASN trans- 
lation is not performed* the 
authorization index is not changed. 

The primary-segment-table designation in 
control register 1 and the linkage-table 
designation in control register 5 are 
replaced as follows: 

• When PASN translation is performed, 
the primary-segment-table designa- 
tion in control register 1 and the 
linkage-table designation in 
control register 5 are replaced 
from the STD-p and LTD-p fields, 
respectively, which are obtained 
during PASN translation. 

• When PASN translation is not 
performed, the primary-segment- 
table-designation and linkage- 
table-designation fields remain 
unchanged. 

The contents of the secondary-segment- 
table designation in control register 7 
are replaced as follows: 

• When SASN-d equals PASN-d, by the 
new contents of control register 1, 
the primary-segment-table desig- 
nation. 

• When SASN translation is performed, 
by the contents of the STD-s. 

When SASN-d does not equal PASN-d and 
SASN translation is not performed, the 
secondary-segment-table designation re- 
mains unchanged. 



Other Condition-Code Settings 



Special Condi tions 



The instruction can be executed only 
when the ASN-translati on control, bit 12 
of control register 14, is one. If the 
ASN-translati on-control bit is zero, a 
special-operation exception is recog- 
ni zed. 

The first operand must be designated on 
a doubleword boundary; otherwise, a 
specification exception is recognized. 

The operation is suppressed on all 
addressing and protection exceptions. 

The figures "Summary of Actions: LOAD 
ADDRESS SPACE PARAMETERS" and "Priority 
of Execution: LOAD ADDRESS SPACE PARAM- 
ETERS" summarize the functions of the 
instruction and the priority of recogni- 
tion of exceptions and condition codes. 

Resulti no Condi ti on Code : 

Translation and authorization 
complete; parameters loaded 

1 Primary ASN not available; 
parameters not loaded 

2 Secondary ASN not available or 
not authorized; parameters not 
loaded 

3 Space-switch event specified; 
parameters not loaded 

Program Excepti ons : 

Access (fetch, operand 1) 

Addressing (ASN-f i rst-table entry, 
ASN-second-table entry, 

authority-table entry) 

ASN-translati on specification 

Privileged operation 

Special operation 

Speci f icati on 



When PASN translation is called for and 
cannot be completed because bit is one 
in either the ASN-f i rst-table or the 
ASN-second-table entries, condition code 
lis set, and the control registers are 
not changed. 

When (1) PASN translation is called for 
and completed and (2) either the current 
space-switch-event-control bit, bit of 
control register 1 is one or the space- 
switch-event-control bit in the ASN- 
second-table entry is one, condition 
code 3 is set, and the control registers 
are not changed. 

When SASN translation is called for and 
the translation cannot be completed 
because bit is one in either the ASN- 
fi rst-table or ASN-second-table entries, 
or because SASN authorization is called 
for and the SASN is not authorized, 
condition code 2 is set, and the control 
registers are not changed. 
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1.-6. Exceptions with the same priority as the priority of program- 
interruption conditions for the general case. 

7. A Access exceptions for second and third instruction halfwords. 

7.B.1 Privileged-operation exception. 

7.B.2 Special-operation exception due to the ASN-translati on control* 
bit 12 of control register 14, being zero. 

8. Specification exception. 

9. Access exceptions for the first operand. 

10. Execution of PASN translation (when performed). 

10.1 Addressing exception for access to ASN-f i rst-table entry. 

10.2 Condition code 1 due to I bit (bit 0) in ASN-f i rst-table entry 
being one. 

10.3 ASN-translation-speci f icati on exception due to invalid ones (bits 
28-31) in ASN-f i rst-table entry. 

10. 4 Addressing exception for access to ASN-second-table entry. 

10.5 Condition code 1 due to I bit (bit 0) in ASN-second-table entry 
being one. 

10.6 ASN-translation-speci fi cati on exception due to invalid ones (bits 
30, 31, 60-63) in ASN-second-table entry. 

10.7 Condition code 3 due to either the old or new space-switch-event- 
control bit being one. 

11. Execution of SASN translation (when performed). 

11.1 Addressing exception for access to ASN-f i rst-table entry. 

11.2 Condition code 2 due to I bit (bit 0) in ASN-f i rst-table entry 
being one. 

11.3 ASN-translati on-speci f i cati on exception due to invalid ones (bits 
28-31) in ASN-f i rst-table entry. 

11.4 Addressing exception for access to ASN-second-table entry. 

11.5 Condition code 2 due to I bit (bit 0) in ASN-second-table entry 
being one. 

11.6 ASN-translati on-speci fication exception due to invalid ones (bits 
30, 31, 60-63) in ASN-second-table entry. 

12. Execution of secondary authorization (when performed). 

12.1 Condition code 2 due to authority-table entry being outside table 

12.2 Addressing exception for access to authority-table entry. 

12.3 Condition code 2 due to S bit in authority-table entry being zero 



Priority of Execution: LOAD ADDRESS SPACE PARAMETERS 
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PASN-d 
Equals 
PASN-old 


Second- 

Operand- 

Address 

Bits* 


PASN 
Translation 
Performed 


Result Field 


29 


30 


PSTD-new 


AX-new 


LTD-new 


PKM-new 


SASN-new 


PASN-new 


Yes 

Yes 

Yes 

Yes 

No 

No 




1 
1 



1 

1 

1 


No 

No 

Yes 

Yes 

Yes 

Yes 


PSTD-old 

PSTD-old 

STD-p 

STD-p 

STD-p 

STD-p 


AX-old 

AX-d 

AX-p 

AX-d 

AX-p 

AX-d 


LTD-old 

LTD-old 

LTD-p 

LTD-p 

LTD-p 

LTD-p 


PKM-d 
PKM-d 
PKM-d 
PKM-d 
PKM-d 
PKM-d 


SASN-d 
SASN-d 
SASN-d 
SASN-d 
SASN-d 
SASN-d 


PASN-d 
PASN-d 
PASN-d 
PASN-d 
PASN-d 
PASN-d 



Summary of Actions: LOAD ADDRESS SPACE PARAMETERS (Part 1 of 2) 



SASN-d 
Equals 
PASN-d 


SASN-d 
Equals 
SASN-old 


Second-Operand- 
Address Bits* 


SASN 
Translation 
Performed 


SASN 
Authori zati on 
Performed** 


Result Field 
SSTD-new 


29 


31 


Yes 

No 

No 

No 

No 

No 


Yes 

Yes 

Yes 

No 

No 



1 


1 
1 

1 



No 

No 

Yes 

Yes 

Yes 

Yes 


No 

No 

No 

Yes 

No 

Yes 


PSTD-new 

SSTD-old 

STD-s 

STD-s 

STD-s 

STD-s 


Explanation: 






- Action in thi« 
comparison or 

X Second-operan< 

29 Force 

30 Use A) 

31 Skip . 

** SASN authorize 


5 case i« 
of the ! 

j-addres! 

ASN trar 

< from f 

secondary 

ation is 


5 the sar 
setting < 

s bits: 
islation 
irst opei 
/ author 

perform* 


ne regardless 
if this bit. 

'•and. 

i ty test. 

ad using AT0- 


3 of the outcome of this 
-s, ATL-s, and AX-new. 



Summary of Actions: LOAD ADDRESS SPACE PARAMETERS (Part 2 of 2) 



Programming Notes 



Bits 29 and 31 in the second- 
operand address are intended prima- 
rily to provide improved 
performance for those cases where 
the associated action is unneces- 
sary. 

When bit 29 is set to zero, the 
action of the instruction is based 
on the assumption that the current 
values for PSTD-old, LTD-old, and 
AX-old are consistent with PASN-old 
and that SSTD-old is consistent 
with SASN-old. When this is not 
the case, bit 29 should be set to 
one. 

Bit 31, when one, eliminates the 
SASN-authorization test. The 



program may be able to determine in 
certain cases that the SASN is 
authorized, either because of prior 
use or because the AX being loaded 
is authorized to access all address 
spaces. 

The SASN-translation and SASN- 
authorization steps are not 
performed when SASN-d is equal to 
PASN-d. This is consistent with 
the action in SET SECONDARY ASN to 
current primary (SSAR-cp), which 
does not perform the translation or 
ASN authorization. 

See the figure "Summary of Abbrevi- 
ations for LOAD ADDRESS SPACE 
PARAMETERS" for a listing of abbre- 
viations used in this instruction 
description. 
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Control- 


Abbreviation for 






Regi ster 


Previ ous 


Subsequent 


Number. Bi t 


Contents 


Contents 


1.0-31 


PSTD-old 


PSTD-new 


3.0-15 


PKM-old 


PKM-new 


3.16-31 


SASN-old 


SASN-new 


4.0-15 


AX-old 


AX-new 


4.16-31 


PASN-old 


PASN-new 


5.0-31 


LTD-old 


LTD-new 


7.0-31 


SSTD-old 


SSTD-new 



Fi rst-Operand 
Bit Positions 


Abbreviati on 


0-15 
16-31 
32-47 
48-63 


PKM-d 
SASN-d 
AX-d 
PASN-d 



Field in ASN- 
Second-Table 
Entry 


Abbreviation Used for 
the Field When Accessed 
as Part of 


PASN 
Translati on 


SASN 
Translation 


1-29 
32-47 
48-59 
64-95 
96-127 


AX-p 

STD-p 
LTD-p 


ATO-s 

ATL-s 
STD-s 


Explanati on: 




- The field 
case. 


i s not used 


i n thi s 



Summary of Abbreviations for LOAD 
ADDRESS SPACE PARAMETERS 
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Fetch op-1 doubleword 



PASN-d = PASN-old 
AND 
Op-2-addr bit 29 = 



No 



Yes 



PSTD-old —» PSTD-tmp 

LTD-old — » LTD-tmp 

AX-old — » AX-tmp 



Yes 



SASN-d = PASN-d 



SASN-d = SASN-old 

AND 
Op-2-addr bit 29 = 

AND 
Op-2-addr bit 31 = 1 



No 



Yes 



PASN translation 



ASN avai lable 



No 



1 — * Cond Code 



Yes 



Either old or new 
space-swi tch-event- 
control bit = 1 



Yes 



No 



STD-p — * PSTD-tmp 

LTD-p — » LTD-tmp 

AX-p -* AX-tmp 



SASN translation 



ASN available 



No 



Yes 



3 — » Cond Code 



2 — * Cond Code 



PSTD-tmp— » SSTD-tmp SSTD-old -* SSTD-tmp 



Op-2-addr bit 30 = 1 



No 



Yes 



AX-d — » AX-new 



AX-tmp — » AX-new 



No 



PSTD-tmp — * PSTD-new 

LTD-tmp — » LTD-new 
SSTD-tmp — * SSTD-new 



STD-s —» SSTD-tmp 



Op-2-addr bit 31 = 



Yes 



SASN authorization 



Yes 



Authorized 



No 



PKM-d — » PKM-new 
SASN-d -* SASN-new 
PASN-d — » PASN-new 



2 — * Cond Code 



Cond Code 



Execution of LOAD ADDRESS SPACE PARAMETERS 
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LOAD CONTROL 



LCTL R,,R 3 ,D a (B a ) 



CRS] 



»B7 f 


R, 


R 3 


B a 


D a 



8 



12 16 



20 



31 



The set of control registers starting 
with control register R t and ending with 
control register R 3 is loaded from the 
locations designated by the second- 
operand address. 

The storage area from which the contents 
of the control registers are obtained 
starts at the location designated by the 
second-operand address and continues 
through as many storage words as the 
number of control registers specified. 
The control registers are loaded in 
ascending order of their register 
numbers^ starting with control register 
R t and continuing up to and including 
control register R 3 , with control regis- 
ter following control register 15. 
The second operand remains unchanged. 



Special Condi ti ons 



The second operand must be designated on 
a word boundary; otherwise, a specifica- 
tion exception is recognized. 



Condi ti on 
unchanged. 



Code: 



The code 



remains 



Program Exceptions : 

Access (fetch, operand 2) 
Privileged operation 
Speci f i cati on 



Programming Notes 



To ensure that existing programs 
operate correctly if and when new 
facilities using additional 
control-register positions are 
defined, only zeros should be load- 
ed in unassigned control-register 
posi tions. 

Loading of control registers on 
some models may require a signif- 
icant amount of time. This is 
particularly true for changes in 
significant parameters. 

For example, the TLB may be cleared 
of entries as a result of changing 
or enabling the program-event- 
recording parameters in control 
registers 9-11. Where possible, 
the program should avoid unneces- 
sary loading of control registers. 



In loading control registers 9-11, 
most models attempt to optimize for 
the case when the bits of control 
register 9 are zeros. 



As another example, the trans 
format, bits 8-12 of control 
ter 0, is initialized to all 
by initial CPU reset. An al 
value is an invalid trans 
format, and, on some m 
results in purging the TLB 
though DAT may be off. Thu 
program should avoid loading 
id values for this field. 



lati on 
regi s- 
zeros 
1-zero 
lati on 
odels, 
even 
s, the 
i nval- 



LOAD PSW 



LPSW D 9 (B a ) 



CS] 



»82» 


//////// 


B, 


D a 



8 



16 



20 



31 



The current PSW i s replaced by the 

contents of the doubleword at the 

location designated by the second- 
operand address. 



Bits 8-15 
ignored. 



of the instruction are 



A serialization and checkpoint-synchron- 
ization function is performed before or 
after the operand is fetched and again 
after the operation is completed. 



Special Condi ti ons 



The operand must be designated on a 
doubleword boundary; otherwise, a spec- 
ification exception is recognized. 

The value which is to be loaded by the 
instruction is not checked for validity 
before it is loaded. However, imme- 
diately after loading, a specification 
recognized and a program 
occurs when any of the 
true for the newly loaded 



exception is 
interrupti on 
following is 
PSW: 



• A one is introduced into an unas- 
signed bit position of the PSW 
(that is, any of bit positions 0, 
2-4, 17, or 24-31). 

• A zero is introduced into bit posi- 
tion 32 of the PSW, but bits 33-39 
are not all zeros. 

• A zero is introduced into bit posi- 
tion 12 of the PSW. 

In these cases, the operation is com- 
pleted, and the resulting instruction- 
length code is zero. 
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The test for a specification exception 
after the PSW is loaded is described in 
the section "Early Exception Recogni- 
tion" in Chapter 6, Interruptions." It 
may be considered as occurring early in 
the process of preparing to execute the 
subsequent instruction. 

The operation is suppressed on all 
addressing and protection exceptions. 

Condition Code : The code is set as 
specified in the new PSW loaded. 

Program Exceptions : 

Access (fetch, operand 2) 
Privileged operation 
Speci f i cati on 



LOAD REAL ADDRESS 



LRA 



R,,D 2 (X 2 ,B 2 ) 



CRX] 



Condition code is set when translation 
can be completed, that is, when the 
entry in each table lies within the 
specified table length and its I bit is 
zero. 

When the I bit in the segment-table 
entry is one, condition code 1 is set, 
and the real address of the segment- 
table entry is placed in general regis- 
ter R t . When the I bit in the page- 
table entry is one, condition code 2 is 
set, and the real address of the page- 
table entry is placed in general 
register R t . When either the segment- 
table entry or the page-table entry is 
outside the table, condition code 3 is 
set, and general register Ri contains 
the real address of the entry that would 
have been fetched if the length 
violation had not occurred. In all 
these cases, a zero is appended on the 
left of the resultant 31-bit real 
address to produce a 32-bit result, and 
the 32-bit result is placed in the 
regi ster . 



■Bl» 


R. 


x a 


B, 


D a 



8 



12 



16 



20 



31 



Special Condi ti ons 



The real address corresponding to the 
second-operand virtual address is placed 
in general register R t . 

The virtual address specified by the X 2 , 
B 2 , and D 2 fields is translated by means 
of the dynamic-address-translation 
facility, regardless of whether DAT is 
on or off. 

The translation is performed by using 
the contents of control register 1 as a 
segment-table designation when bit 16 of 
the current PSW is zero or the contents 
of control register 7 as a segment-table 
designation when bit 16 of the current 
PSW is one. 

The translation is performed without the 
use of the translation-lookaside buffer 
(TLB). A zero is appended on the left 
of the resultant 31-bit real address to 
produce a 32-bit result, which is then 
placed in general register R t . The 
translated address is not inspected for 
boundary alignment or for addressing or 
protection exceptions. 

The virtual-address computation is 
performed according to the current 
addressing mode, specified by bit 32 of 
the current PSW. 

The addresses of the segment-table entry 
and page-table entry are treated as 
31-bit addresses, regardless of the 
current addressing mode specified by bit 
32 of the current PSW. It is unpredict- 
able whether the addresses of these 
entries are treated as real or absolute 
addresses. 



A translation-specification exception is 
recognized when bits 8-12 of control 
register contain an invalid code, or 
the segment-table entry or page-table 
entry has the I bit with a value of zero 
and has a format error. 



A carry into bit position 
of the addition done to 
address of either the 
entry or the page-table 
ignored or may result in 
exception. 



as a result 
compute the 
segment-table 
entry may be 
an addressing 



The operation is suppressed on all 
addressing exceptions. 

Resulting Condi ti on Code : 

Translation available 

1 Segment-table entry invalid (I 
bit is one) 

2 Page-table entry invalid (I bit 
is one) 

3 Segment- or page-table length 
exceeded 

Program Except i ons : 

Addressing (segment-table entry or 

page-table entry) 
Privileged operation 
Translation specification 



Programming Note 



Caution must be exercised in the use of 
LOAD REAL ADDRESS in a multiprocessing 
configuration. Since INVALIDATE PAGE 
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TABLE ENTRY may set the I bit in storage 
to one before causing the corresponding 
entries in TLBs of other CPUs to be 
cleared, the simultaneous execution of 
LOAD REAL ADDRESS on this CPU and INVAL- 
IDATE PAGE TABLE ENTRY on another CPU 
may produce inconsistent results. 
Because LOAD REAL ADDRESS accesses the 
tables in storage* the page-table entry 
may appear to be invalid (condition code 
2) even though the corresponding TLB 
entry has not yet been cleared, and the 
TLB entry may remain in the TLB until 
the completion of INVALIDATE PAGE TABLE 
ENTRY on the other CPU. There is no 
guaranteed limit to the number of 
instructions which may occur between the 
completion of LOAD REAL ADDRESS and the 
TLB being cleared of the entry. 



MOVE TO PRIMARY 



space. The first-operand address is 
translated by using the secondary 
segment table, and the second-operand 
address is translated by using the 
primary segment table. 

Bit positions 24-27 of general register 
R 3 are used as the secondary-space 
access key. Bit positions 0-23 and 
28-31 of the register are ignored. 



The contents of general 
a 32-bit unsigned value 
length. 



regi ster Ri are 
called the true 



The contents of the general registers 
just described are as follows: 



R, 



True Length 



31 



MVCP D.CR^BiKDaCB,),!*, 



[SS] 



DA 



Ri 



B, 



D! 



-/ — i 



8 12 16 20 32 36 47 



MOVE TO SECONDARY 



MVCS D,(R 1 ,B 1 ),D a (B a ),R 3 



[SS] 



DB 



R. 



B, 



D, 



-/ — I 

D 2 
— -/ I 



8 12 16 20 32 36 47 

replaced by the 
erand is in the 
nd the other i s 
55 space. The 

in the primary 

using the PSW 

e operand in the 

formed by using 

third operand. 



The first operand is 
second operand. One op 
primary address space, a 
in the secondary addre 
accesses to the operand 
space are performed by 
key; the accesses to th 
secondary space are per 
the key specified by the 



The addresses of the first and second 
operands are virtual, one operand 
address being translated by means of the 
primary segment-table designation and 
the other by means of the secondary 
segment-table designation. Operand- 
address translation is performed by 
ignoring the state of the address- 
space-control bit in the current PSW. 

For MOVE TO PRIMARY, movement is to the 
primary space from the secondary space. 
The first-operand address is translated 
by using the primary segment table, and 
the second-operand address is translated 
by using the secondary segment table. 

For MOVE TO SECONDARY, movement is to 
the secondary space from the primary 



//////////////////////// 


Key 


//// 



24 



28 31 



The first and second operands are the 
same length, called the effective 
length. The effective length is equal 
to the true length, or 256, whichever is 
less. Access exceptions for the first 
and second operands are recognized only 
for that portion of the operand within 
the effective length. When the effec- 
tive length is zero, no access 
exceptions are recognized for the first 
and second operands, and no movement 
takes place. 

Each storage operand is processed left 
to right. The storage-operand- 
consistency rules are the same as for 
MOVE (MVC), except that when the oper- 
ands overlap in real storage, the use of 
the common real-storage locations is not 
necessarily recognized. 

As part of the execution of the instruc- 
tion, the value of the true length is 
used to set the condition code. If the 
true length is 256 or less, including 
zero, the true length and effective 
length &re equal, and condition code 
is set. If the true length is greater 
than 256, the effective length is 256, 
and condition code 3 is set. 

For both MOVE TO PRIMARY and MOVE TO 
SECONDARY, a serialization and check- 
point-synchronization function is 
performed before the operation begins 
and again after the operation is 
completed. 



Special Condi tions 



Since the secondary space is accessed, 
the operation is performed only when the 
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secondary-space control* bit 5 of 
control register 0, is one and DAT is 
on. When either the secondary-space 
control is zero or DAT is off, a 
special-operation exception is recog- 
nized. The special-operation exception 
is recognized in both the problem and 
supervisor states. 

In the problem state, the operation is 
performed only if the secondary-space 
access key is valid, that is, if the 
corresponding PSW-key-mask bit in 
control register 3 is one. Otherwise, a 
privileged-operation exception is recog- 
nized. In the supervisor state, any 
value for the secondary-space access key 
is valid. 

The priority of the recognition of 
exceptions and condition codes is shown 
in the figure "Priority of Execution: 
MOVE TO PRIMARY and MOVE TO SECONDARY." 



Programming Notes 



MOVE TO PRIMARY and MOVE TO SECOND- 
ARY can be used in a loop to move a 
variable number of bytes of any 
length. See the programming note 
under MOVE WITH KEY. 

MOVE TO PRIMARY and MOVE TO SECOND- 
ARY should be used only when move- 
ment is between different address 
spaces. The performance of these 
instructions on most models may be 
significantly slower than MOVE WITH 
KEY, MOVE (MVC), or MOVE LONG. In 
addition, the definition of over- 
lapping operands for MOVE TO 
PRIMARY and MOVE TO SECONDARY is 
not compatible with the more 
precise definitions for MOVE (MVC), 
MOVE WITH KEY, or MOVE LONG. 



Resulti ngi Condi ti on Code : 

True length less than or equal 

to 256 
1 
2 
3 True length greater than 256 

Program Exceptions : 

Access (fetch, primary virtual ad- 
dress, operand 2, MVCS; fetch, 
secondary virtual address, op- 
erand 2, MVCP; store, secondary 
virtual address, operand 1, 
MVCS; store, primary virtual 
address, operand 1, MVCP) 

Privileged operation (selected 
PSW-key-mask bit is zero in the 
problem state) 

Special operation 



1.-6. Exceptions with the same pri- 
ority as the priority of pro- 
gram-interruption conditions 
for the general case. 

7. A Access exceptions for second 
and third instruction half- 
words. 

7.B Special-operation exception due 
to the secondary-space control, 
bit 5 of control register 0, 
being zero or to DAT being off. 

8. Privileged-operation exception 
due to selected PSW-key-mask 
bit being zero in the problem 
state. 

9. Completion due to length zero. 
10. Access exceptions for operands. 



MOVE WITH KEY 



MVCK 



D, (R, ,B, ),D a (B a ),R 3 



CSS] 



D9 



R« 



B, 



Dt 



3 



8 



12 



16 



20 



32 



36 47 



The first operand is replaced by the 
second operand. The fetch accesses to 
the second-operand location are 
performed by using the key specified in 
the third operand, and the store 
accesses to the first-operand location 
are performed by using the PSW key. 



Bit positions 24-27 
R 3 are used as the 
Bit positions 0-23 
register sre ignored. 



of general register 
source access key. 
and 28-31 of the 



The contents of general 
a 32-bit unsigned value 
length. 



register R< are 
called the true 



The contents of the general registers 
just described are as follows: 



Ri 



True Length 



31 



//////////////////////// 


Key 


//// 



24 



28 31 



The first and second operands &r& the 
same length, called the effective 
length. The effective length is equal 



Pri ori ty 
and MOVE 



of 
TO 



Execution: 
SECONDARY 



MOVE TO PRIMARY 
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sed left 


8. 


operands 




d as if 




byte at 




e stored 




operand 


9. 


operand- 




as for 


10. 



to the true length* or 256* whichever is 
less. Access exceptions for the first 
and second operands are recognized only 
for that portion of the operand within 
the effective length. When the effec- 
tive length is zero, no access 
exceptions are recognized for the first 
and second operands, and no movement 
takes place. 



Each storage operand is proces 
to right. When the storage 
overlap, the result is obtaine 
the operands were processed one 
a time and each result byte wer 
immediately after the necessary 
byte was fetched. The storage- 
consistency rules are the same 
the MOVE (MVC) instruction. 



As part of the execution of the instruc- 
tion, the value of the true length is 
used to set the condition code. If the 
true length is 256 or less, including 
zero, the true length and effective 
length are equal, and condition code 
is set. If the true length is greater 
than 256, the effective length is 256, 
and condition code 3 is set. 



Special Condi ti ons 

In the problem state, the operation is 
performed only if the source access key 
is valid, that is, if the corresponding 
PSW-key-mask bit in control register 3 
is one. Otherwise, a privileged- 
operation exception is recognized. In 
the supervisor state, any value for the 
source access key is valid. 

The priority of the recognition of 
exceptions and condition codes is shown 
in the figure "Priority of Execution: 
MOVE WITH KEY Instruction." 

Resulti ng Condi ti on Code : 

True length less than or equal 

to 256 
1 
2 
3 True length greater than 256 

Program Except i ons ? 

Access (fetch, operand 2; store, 

operand 1) 
Privileged operation (selected 

PSW-key-mask bit is zero in the 

problem state) 



1.-6. Exceptions with the same pri- 
ority as the priority of pro- 
gram-interruption conditions 
for the general case. 



7. A 



Access exceptions for second 
and third instruction half- 
words. 

Privileged-operation exception 
due to selected PSW-key-mask 
bit being zero in the problem 
state. 

Completion due to length zero. 

Access exceptions for operands, 



Priority of Execution: MOVE WITH KEY 



Programmi ng Notes 



MOVE WITH KEY can be used in a loop 
to move a variable number of bytes 
of any length, as follows: 



LOOP 



END 

The performance of MOVE WITH KEY on 
most models may be significantly 
slower than that of the MOVE (MVC) 
and MOVE LONG instructions. There- 
fore, MOVE WITH KEY should not be 
used if the key of the source and 
the target are the same. 



PROGRAM CALL 



LA 


RW,256 


MVCK 


D, (R, ,Bt ),D 2 (B 2 ),R 3 


BC 


8, END 


AR 


B,,RW 


AR 


B 3 ,RW 


SR 


R,,RW 


B 


LOOP 



PC 



D 2 (B 2 ) 



ES3 



'B218' 


B a 


D a 



A two-level lookup is p 
locate an entry-table entry 
ETE contains an authorizati 
an ASN, an entry paramete 
loaded into general regis 
information to update the 
in control register 3 and to 
problem-state bit, addressi 
instruction address in the 
original contents of th 
register and the PSW fields 
general registers 3 and 14. 



16 20 31 

erformed to 
(ETE). The 
on-key mask; 
r, whi ch i s 
ter 4; and 
PSW-key mask 
replace the 
ng bit, and 
PSW. The 
e control- 
are saved in 
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The ETE also causes a space-switching 
operation to occur if it specifies a 
nonzero ASN. When the ETE specifies a 
zero ASN, the operation is called 
PROGRAM CALL to current primary (PC-cp); 
when the ETE specifies a nonzero ASN, 
the operation is called PROGRAM CALL 
with space switching (PC-ss). When 
space switching is specified, the new 
PASN is loaded into control register 4 
from the ETE and is used in a two-level 
lookup to locate an ASN-second-table 
entry (ASTE). From this ASTE, a new 
PSTD, AX, and LTD are loaded into 
control registers 1, 4 , and 5, respec- 
tively. Whether or not space switching 
is specified, the previous PASN and PSTD 
are placed in the SASN and SSTD, respec- 
tively, and the previous PASN is saved 
in general register 3. 



PROGRAM CALL PC-Number Translation 

The second-operand address i s not used 
to address data; instead, the rightmost 
20 bits of the address are used as a 
program-call number and have the follow- 
ing format: 

Second-Operand Address 

j— Program-Call Number — | 



//////////// 


LX 


EX 



12 



24 



31 



Linkage Index ( LX) : Bits 12-23 of the 
second-operand address are the linkage 
index and are used to select an entry 
from the linkage table designated by the 
linkage-table designation in control 
register 5. 

Entry Index (EX): Bits 24-31 of the 
second-operand address are the entry 
index and are used to select an entry 
from the entry table designated by the 
linkage-table entry. 

Bits 0-11 of the second-operand address 
are ignored. 

The linkage-table and entry-table lookup 
process is depicted in part 1 of the 
figure "Execution of PROGRAM CALL." The 
detailed definition for this table- 
lookup process is in the section 
"PC-Number Translation" in Chapter 5, 
"Program Execution." The entry-table 
entry has the following format' 



AKM 


ASN 


A 


IA 


P 


16 


32 


63 


PARM 


EKM 


///////// 



64 



96 



112 



127 



When bit 32 of the ETE is zero (24-bit 
addressing mode), then bits 33-39 of the 
ETE must be zeros; otherwise, a PC- 
translation-specification exception is 
recogni zed. 

After the entry-table entry has been 
fetched, if the current PSW specifies 
the problem state, the current PSW-key 
mask in control register 3 is tested 
against the AKM field in the entry-table 
entry to determine whether the program 
is authorized to access this entry. The 
AKM and PSW-key mask are ANDed, and if 
the result is zero, a privileged- 
operation exception is recognized. When 
PROGRAM CALL is executed in the supervi- 
sor state, the AKM field is ignored. 



If the result of 
the PSW-key mask 
CPU is in the 
execution of the 



the AND of the AKM and 
is not zero, or if the 
supervisor state, the 
instruction continues. 



The PSW-key mask, bits 0-15 of control 
register 3, is placed in bit positions 
0-15 of general register 3, and the 
current PASN, bits 16-31 of control 
register 4, is placed in bit positions 
16-31 of general register 3. 

The current PSTD, bits 0-31 of control 
register 1, is placed in control regis- 
ter 7 to become the current SSTD. 

The current PASN, bits 16-31 of control 
register 4, is placed in bit positions 
16-31 of control register 3 to become 
the current SASN. 

Bits 32-62 of the current PSW (the 
addressing bit and the updated instruc- 
tion address) are placed in bit posi- 
tions 0-30 of general register 14. Bit 
15 of the PSW (the problem-state bit) is 
placed in bit position 31 of general 
register 14. 

Bits 32-62 of the ETE, with a zero 
appended on the right, are placed in PSW 
bit positions 32-63 (the addressing bit 
and the instruction address). Bit 63 of 
the ETE is placed in PSW bit position 15 
(the problem-state bit). 

Bits 64-95 of the ETE (the entry parame- 
ter) are loaded into general register 4. 

Bits 96-111 of the ETE (the EKM) are 
ORed with the PSW-key mask, bits 0-15 of 
control register 3, and the result 
replaces the PSW-key mask in control 
register 3. 
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PROGRAM CALL to Current Primary (PC-cp) 



If bits 16-31 of the ETE (the ASN) are 
zeros, a PROGRAM CALL to current primary 
(PC-cp) is specified, and the operation 
is completed after performing those 
actions as described above. 

The PC-cp operation is depicted in parts 
1 and 2 of the figure "Execution of 
PROGRAM CALL." 



PROGRAM 
(PC-ss) 



CALL wi th Space Swi tchi nq 



If the ASN in the ETE is nonzero, a 
PROGRAM CALL with space switching 
(PC-ss) instruction is specified, and 
the ASN is translated by means of a 
two-level table lookup. 

The PC-ss operation is depicted in parts 
1, 2 and 3 of the figure "Execution of 
PROGRAM CALL." The PC-ss operation is 
completed as follows: 



Bits 
10-b 
tabl 
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sect 
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The s 
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Chapter 3, 
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Bits 16-31 of the entry-table entry are 
placed in bit positions 16-31 of control 
register 4 as the new PASN. 

Bits 64-95 of the ASN-second-table entry 
(the STD) are loaded into control regis- 
ter 1 as the new PSTD. 

Bits 32-47 of the ASN-second-table entry 
(the AX) are loaded into bit positions 
0-15 of control register 4 as the new 
authorization index. 

Bits 96-127 of the ASN-second-table 
entry (the LTD) are loaded into control 
register 5 as the new linkage-table 
desi gnati on. 

For both the PC-cp and PC-ss operations, 
a serialization and checkpoint-synch- 



ronization function is performed before 
the operation begins and again after the 
operation is completed. 



Special Condi ti ons 



The instruction can be executed only 
when the CPU is in primary-space mode 
and the subsystem-linkage control, bit 
of control register 5, is one. If the 
CPU is in real mode or secondary-space 
mode, or if the subsystem-linkage 
control is zero, a special-operation 
exception is recognized. In addition, 
the PC-ss instruction can be executed 
only when the ASN-translati on control, 
bit 12 of control register 14, is one. 
If PC-ss is attempted with the ASN- 
translation control zero, a special- 
operation exception is recognized. The 
special-operation exception is recog- 
nized in both the problem and supervisor 
states. 



When, for PC-ss, th 
event-control bit, bi 
register 1, is one e 
after the execution of 
a space-switch-event 
ruption occurs after 
completed. A space-swi 
interruption also oc 
completion of a PC-ss o 
event is reported. 



e space-swi 
t of con 
ither before 
the instruct 
program in 
the operation 
tch-event pro 
curs after 
peration if a 



The operation is suppressed 
addressing exceptions. 



on 



tch- 

trol 

or 

i on, 

tei — 

i s 

gram 

the 

PER 



all 



The priority of recognition of program 
exceptions for the instruction is shown 
in the figure "Priority of Execution: 
PROGRAM CALL." 



Condi ti on 
unchanged. 



Code; 



The 



code 



remai ns 



Program Excepti ons : 

Addressing (linkage-table entry or 

entry-table entry) 
ASN translation (PC-ss only) 
EX translation 
LX translation 

PC-translation specification 
Privileged operation (AND of AKM 

and PSW-key mask is zero in the 

problem state) 
Space-switch event (PC-ss only) 
Special operation 
Trace 
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1.-6. Exceptions with the same priority as the priority of program- 
interruption conditions for the general case. 

7. A Access exceptions for second instruction halfword. 

7.B Special-operation exception due to DAT being off, the CPU 
being in secondary-space mode, or the subsystem-linkage- 
control bit in control register 5 being zero. 

8. A Trace exceptions. 

8.B.1 LX-translati on exception due to linkage-table entry being 
outside table. 

8.B.2 Addressing exception for access to linkage-table entry. 

8.B.3 LX-translati on exception due to I bit (bit 0) in linkage-table 
entry being one. 

8.B.4 EX-translati on exception due to entry-table entry being out- 
side table. 

8.B.5 Addressing exception for access to entry-table entry. 

8.B.6 PC-translation-specification exception due to invalid combi- 
nation (bit 32 is zero and bits 33-39 not zeros) in entry- 
table entry. 

8.B.7 Privileged-operation exception due to a zero result from 
ANDing PSW-key mask and AKM in the problem state. 

8.B.8 Special-operation exception due to the ASN-translati on con- 
trol, bit 12 of control register 14, being zero (PC-ss only). 

8.B.9 ASN-translati on exceptions (PC-ss only). 

9. Space-switch event (PC-ss only). 



Priority of Execution: PROGRAM CALL 
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PROGRAM CALL Instruction 



B218 



B a 



CR5 



LTO 



LTL 



(x!28) 



» + 



Linkage Table 



ETO 



ETL 



(x64) 



Entry Table 



--» + 



Operand-2 
^ Address 



////// 



LX 



EX 



(x«) (xl6) 



AKM 



ASN 



IA 



PARM 



EKM 



//////// 



R: Address is real 



Execution of PROGRAM CALL (Part 1 of 3): PC-Number Translation 
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Entry-Table Entry 



A KM 



ASN 



IA 



PSW 
after 



rnzT 



AND »Priv op 

' if zero in 

1* problem state 



CR3 
before 



PKM 



SASN 



I 
4> 



OR 



CR3 
after 



GR3 

after PKM 



PASN 



PARM 



EKM 



GR4 
after 



PARM 



IA 



//////// 



CR1 
before 



CR7 
after 



PSTD 



SSTD 



CR4 
before 



AX 



PASN 



PSW 
before 



CI 



PKM 


SASN 



IA 



GR14 
after 



IA 



Yes 



= 



No 



* 


* 


PC-cp 


PC-ss 


Instruct! on 


ASN trans 


complete 


lati on 



Execution of PROGRAM CALL (Part 2 of 3): PC-cp and PC-ss 
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Entry-Table Entry 



A KM 



ASN 



IA 



PARM 



EKM //////// 



CR14 



AFTO 



Cx«096) 



AFX 



(x4) 



ASX 



ASN First Table 



ASTO 



(x!6) 



(xl6) 



ASN Second Table 



ATO AX 



ATL 



CR1 
after 



PSTD 



STD 



LTD 



CR4 

after AX 



CR5 
after 



PASN 



LTD 



R: Address is real 



Execution of PROGRAM CALL (Part 3 of 3): ASN Translation for PC-ss 
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PROGRAM TRANSFER 



PT 



R i , R j 



[RRE] 



'B228' 


//////// 


Ri 


R 2 



16 



24 



28 31 



The contents of general register R t are 
used as the new values for the PSW-key 
mask, the PASN, and the SASN. The 
contents of general register R 2 are used 
as the new values for the problem-state 
bit, addressing-mode bit, and instruc- 
tion address in the current PSW. 



Bits 16-23 
i gnored. 



of the instruction are 



General registers R t and R a have the 
following format: 



R, 



PSW-Key Mask 


ASN 



16 



31 



Instruction Address 







31 



When the contents of bit positions 16-31 
of general register R, are equal to the 
current PASN, the operation is called 
PROGRAM TRANSFER to current primary 
(PT-cp); when the fields are not equal, 
the operation is called PROGRAM TRANSFER 
with space switching (PT-ss). 

The contents of general registar R a are 
used to update the problem-state bit, 
the addressing-mode bit, and the 
instruction address of the current PSW. 
Bit 31 of general register R 2 is placed 
in the problem-state bit position, PSW 
bit position 15, unless the operation 
would cause PSW bit 15 to change from 
one to zero (problem state to supervisor 
state). If such a change would occur, a 
privileged-operation exception is recog- 
nized. Bits 0-30 of general register R a 
replace the addressing-mode bit and the 
instruction address, bits 32-62 of the 
current PSW. Bit 63 of the PSW is set 
to zero. 

Bits 0-15 of general register R, are 
ANDed with the PSW-key mask, bits 0-15 
of control register 3, and the result 
replaces the contents of the PSW-key 
mask. 

In both the PT-ss and PT-cp 
instructions, the ASN specified by bits 
16-31 of general register Ri replaces 
the SASN in control register 3, and the 
SSTD in control register 7 is replaced 
by the final contents of control regis- 
ter 1. 



PROGRAM TRANSFER to Current Primary 
(PT-cp) 



The PROGRAM TRANSFER to current primary 
(PT-cp) operation is depicted in part 1 
of the figure "Execution of PROGRAM 
TRANSFER." On a PT-cp operation, the 
operation is completed when the common 
portion of the PROGRAM TRANSFER opera- 
tion, described above, is completed. 
The authorization index, PASN, primary 
STD, and linkage-table designation are 
not changed by PT-cp. 



PROGRAM TRANSFER with Space Switching 
(PT-ss) 



If the ASN in bits 16-31 of general 
register R t is not equal to the current 
PASN, a PROGRAM TRANSFER with space 
switching (PT-ss) is specified, and the 
ASN is translated by means of a two- 
level table lookup. 

The PT-ss operation is depicted in parts 
1 and 2 of the figure "Execution of 
PROGRAM TRANSFER." The PT-ss operation 
is completed as follows: 

For a PT-ss, the contents of bit posi- 
tions 16-31 of general register R x are 
used as an ASN, which is translated by 
means of a two-level table lookup. 
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The authority-table origin from the 
ASN-second-table entry is used as the 
base for a third table lookup. The 
current authorization index, bits 0-15 
of control register 4, is used, after it 
has been checked against the authority- 
table length, as the index to locate the 
entry in the authority table. The 
authority-table lookup is described in 
the section "ASN Authorization" in Chap- 
ter 3, "Storage." 

The PT-ss operation is completed by 
placing bits 64-95 of the ASN-second- 
table entry in both the PSTD and SSTD, 
bit positions 0-31 of control registers 
1 and 7, respectively. The contents of 
bit positions 32-47 of the ASN-second- 
table entry are placed in the author iza- 
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tion index, bit positions 0-15 of 
control register 4. The contents of bit 
positions 96-127 of the ASN-second-table 
entry are placed in the LTD, bit posi- 
tions 0-31 of control register 5. The 
ASN, bits 16-31 of general register R t , 
is placed in the SASN and PASN, bit 
positions 16-31 of control registers 3 
and 4 . 

For both the PT-cp and PT-ss operations, 
a serialization and checkpoint-synchron- 
ization function is performed before the 
operation begins and again after the 
operation is completed. 



Special Condi ti ons 



The instruction can be executed only 
when the CPU is in primary-space mode 
and the subsystem-linkage control, bit 
of control register 5, is one. If the 
CPU is in real mode or secondary-space 
mode, or if the subsystem-linkage 
control is zero, a special-operation 
exception is recognized. In addition, 
the PT-ss instruction can be executed 
only when the ASN-translati on control, 
bit 12 of control register 14, is one. 
If PT-ss is attempted with the ASN- 
translation control zero, a special- 
operation exception is recognized. The 
special-operation exception is recog- 
nized in both the problem and supervisor 
states. 

Bit 31 of general register R a is placed 
in the problem-state bit position, PSW 
bit position 15, unless the operation 
would cause PSW bit 15 to change from 
one to zero (problem state to supervisor 
state). If such a change would occur, a 



privileged-operation exception is recog- 
ni zed. 

The instruction is completed only if 
bits 0-7 of general register R a specify 
a valid combination for PSW bits 32-39. 
If bit of general register R 2 is zero 
and bits 1-7 are not zeros, a specifica- 
tion exception is recognized. 

When, for PT-ss, the space-switch- 
event-control bit, bit of control 
register 1, is one either before or 
after the execution of the instruction, 
a space-switch-event program inter- 
ruption occurs after the operation is 
completed. A space-switch-event program 
interruption also occurs after the 
completion of a PT-ss operation if a PER 
event is reported. 



The operation is suppressed 
addressing exceptions. 



on 



all 



The priority of recognition of program 
exceptions for the instruction is shown 
in the figure "Priority of Execution: 
PROGRAM TRANSFER." 



Condi ti on 
unchanged. 



Code: 



The code 



remains 



Program Exceoti ons : 

Addressing (authority-table entry, 

PT-ss only) 
ASN translation (PT-ss only) 
Primary authority (PT-ss only) 
Privileged operation (attempt to 

set the supervisor state when 

in the problem state) 
Space-switch event (PT-ss only) 
Special operation 
Speci f ication 
Trace 
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1.-6. Exceptions with the same priority as the priority of program- 
interruption conditions for the general case. 

7. A Access exceptions for second instruction halfword. 

7.B Special-operation exception due to DAT being off, the CPU 
being in secondary-space mode, or the subsystem-linkage- 
control bit in control register 5 being zero. 

8. A Trace exceptions. 

8.B.1 Privileged-operation exception due to attempt to set the 
supervisor state when in the problem state. 

8.B.2 Specification exception due to a value of zero in bit and a 
nonzero value in bits 1-7 of general register R a . 

8.B.3 Special-operation exception due to the ASN-translati on con- 
trol, bit 12 of control register 14, being zero (PT-ss only). 

8.B.4 ASN-translati on exceptions (PT-ss only). 

8.B.5 Primary-authority exception due to authority-table entry 
being outside table (PT-ss only). 

8.B.6 Addressing exception for access to authority-table entry 
(PT-ss only). 

8.B.7 Primary-authority exception due to P bit in authority-table 
entry being zero (PT-ss only). 

9. Space-switch event (PT-ss only). 



Priority of Execution: PROGRAM TRANSFER 



Programming Notes 



1. The operation of PROGRAM TRANSFER 
(PT) is such that it may be used to 
restore the CPU to the state saved 
by a previous PROGRAM CALL. This 
restoration is accomplished by 
issuing PT 3,14. Though general 
registers 3 and 14 are not restored 
to their original values, the PASN, 
PSW-key mask, problem-state bit, 
addressing mode, and instruction 
address are restored, and the 
authorization index, PSTD, and LTD 
are made consistent with the 
restored PASN. 



With proper authority, and while 
executing in a common area, PROGRAM 
TRANSFER may be used to change the 
primary address space to any 
desired space. The secondary 
address space is also changed to be 
the same as the new primary address 
space. 

Unlike the RR-format branch in- 
structions, a value of zero in the 
R a field for PROGRAM TRANSFER 
designates general register 0, and 
branching occurs. 
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PROGRAM TRANSFER 
Instruction 



B228 



//// 



Ri 









R, 


PKM 


ASN 














CR3 
before 










PKM 


SASN 








> 


r 








— » 


Af 


id 


+ 



CR3 
after 



CR4 



before AX 



PASN 



PKM 


SASN 



4, 4, 
Yes 1 1 No 



PT-cp 
Instruct i on 
complete 



R a A IA P 















1 



PSW 
after 



PT-ss 
See following 
f i gure 



cue 



CR1 
before 



CR7 
after 



IA 



PSTD 



(PT-cp only) 



SSTD 



Execution of PROGRAM TRANSFER (Part 1 of 2): PT-cp and PT-ss 
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CR14 



AFTO 



(x4096) 



AFX 



Cx4) 



ASX 



-•» + 



ASN First Table 



ASTO 



(xl6) 



(xl6) 



R, PKM 



ASN 



4- 
-< — • — »- 



CR4 
before 



AX 



PASN 



(xl/4) 



ASN Second Table 



* R 



ATO 



AX 



(x4) 



n 



ATL 



STD 



Authority Table 



CR1 
after 



CR7 
after 



PSTD 



SSTD 



-»Primary-authori ty exception if P bit is 
zero or if table length is exceeded 



R: Address is real 



Execution of PROGRAM TRANSFER (Part 2 of 2): PT-ss 



LTD 



CR4 

after 



AX 


PASN 



CR5 
after 



LTD 
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PURGE TLB 



PTLB 



m 



f B20D f 


//////////////// 



16 



31 



The translation-lookaside buffer (TLB) 
of this CPU is cleared of entries. No 
change is made to the contents of 
addressable storage or registers. 



Bits 16-31 
ignored. 



of the instruction are 



The TLB appears cleared of its original 
contents beginning with the fetching of 
the next sequential instruction. The 
operation is not signaled to any other 
CPU. 

A serialization function is performed. 

Condi ti on Code : The code remains 
unchanged. 

Program Exceptions : 

Privileged operation 

RESET REFERENCE BIT EXTENDED 



RRBE R,,R. 



[RRE3 



*B22A f 


//////// 


R, 


Ra 



16 



24 



28 31 



The reference bit in the storage key for 
the 4K-byte block that i s addressed by 
the contents of general register R 2 is 
set to zero. The contents of general 
register Ri are ignored. 



Bits 16-23 
i gnored. 



of the instruction are 



In the 24-bit addressing mode, bits 8-19 
of general register R 3 designate a 
4K-byte block in real storage, and bits 
0-7 and 20-31 of the register are 
ignored. In the 31-bit addressing mode, 
bits 1-19 of general register R 2 desig- 
nate a 4K-byte block in real storage, 
and bits and 20-31 of the register ar& 
i gnored. 

Because it is a real address, the 
address designating the storage block is 
not subject to dynamic address trans- 
lation. The reference to the storage 
key is not subject to a protection 
except i on. 



The remaining bits of the storage key, 
including the change bit, are not 
affected. 

The condition code is set to reflect the 
state of the reference and change bits 
before the reference bit is set to zero. 

Resulti ng Condi ti on Code : 

Reference bit zero; change bit 
zero 

1 Reference bit zero; change bit 
one 

2 Reference bit one; change bit 
zero 

3 Reference bit one; change bit 
one 

Program Exceptions : 

Addressing (address specified by 

general register R a ) 
Privileged operation 



SET ADDRESS SPACE CONTROL 



SAC 



D 3 (B 9 ) 



CS] 



, B219» 


B a 


D a 



16 



20 



31 



Bits 20-23 o 
are used as 
space-contro 
second-opera 
address data 
the code, 
second-opera 
Bits 20-22 o 
must be zer 
tion except i 



f the second-operand address 
a code to set the address- 
1 bit in the PSW. The 
nd address is not used to 
; instead, bits 20-23 form 
Bits 0-19 and 24-31 of the 
nd address are ignored, 
f the second-operand address 
os; otherwise, a specifica- 
on is recognized. 



The following figure summarizes the 
operation of SET ADDRESS SPACE CONTROL: 



Second-Operand Address 



//////////////////// 


Code 


//////// 



Code 



20 



Name of Mode 



24 



31 



Result i n 
PSW Bit 16 



0000 
0001 
All others 



Primary space 
Secondary space 1 
Invalid Unchanged 



A serialization and checkpoint-synchron- 
ization function is performed before the 
operation begins and again after the 
operation is completed. 
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Special Conditions 



The operation is performed only when the 
secondary-space control* bit 5 of 
control register 0, is one and DAT is 
on. When either the secondary-space 
control is zero or DAT is off, a 
special-operation exception is recog- 
nized. The special-operation exception 
is recognized in both the problem and 
supervisor states. 

The priority of recognition of program 
exceptions for the instruction is shown 
in the figure "Priority of Execution: 
SET ADDRESS SPACE CONTROL." 



Condi ti on 
unchanged. 



Code: 



The code 



remai ns 



Program Excepti ons : 

Special operation 
Speci f i cati on 



1.-6. Exceptions with the same pri- 
ority as the priority of pro- 
gram-interruption conditions 
for the general case. 

7. A Access exceptions for second 
instruction halfword. 

7.B Special-operation exception 
due to DAT being off or the 
secondary-space control, 
bit 5 of control register 0, 
being zero. 

8. Specification exception due to 
nonzero value in bits 20-22 of 
the second-operand address. 



Priority of Execution: SET ADDRESS 
SPACE CONTROL 



Programmi ng Notes 



SET ADDRESS SPACE CONTROL is 
defined in such a way that the mode 
to be set can be placed directly in 
the displacement field of the 
instruction or can be specified 
from the same bit positions of a 
general register as saved by INSERT 
ADDRESS SPACE CONTROL. 

Predictable program operation is 
ensured in secondary mode only when 
the instructions are fetched from 

locations which 

same real address 

the primary and 

tables. Thus, a 

program should not enter 



vi rtual-address 
translate to the 
by means of both 
secondary segment 



secondary-space mode if it is not 
aware of the virtual-to-real 
mapping in both the primary and 
secondary spaces. 



SET CLOCK 



SCK 



D 3 (B 3 ) 



CS3 



"B204 f 


B a 


D 2 



16 



20 



31 



The current value of the TOD clock is 
replaced by the contents of the double- 
word designated by the second-operand 
address, and the clock enters the 
stopped state. 

The doubleword operand replaces the 
contents of the clock, as determined by 
the resolution of the clock. Only those 
bits of the operand are set in the clock 
that correspond to the bit positions 
which are updated by the clock; the 
contents of the remaining rightmost bit 
positions of the operand are ignored and 
are not preserved in the clock. In some 
models, starting at or to the right of 
bit position 52, the rightmost bits of 
the second operand are ignored, and the 
corresponding positions of the clock 
which ar& implemented are set to zeros. 

After the clock value is set, the clock 
enters the stopped state. The clock 
leaves the stopped state to enter the 
set state and resume incrementing under 
control of the TOD-clock-sync control 
(bit 2 of control register 0). When the 
bit is zero, the clock enters the set 
state at the completion of the instruc- 
tion. When the bit is one, the clock 
remains in the stopped state either 
until the bit is set to zero or until 
any other running TOD clock in the 
configuration is incremented to a value 
of all zeros in bit positions 32-63. 

When the TOD clock is shared by another 
CPU, the clock remains in the stopped 
state under control of the TOD-clock- 
sync control bit of the CPU which set 
the clock. If, while the clock is 
stopped, it is set by another CPU, then 
the clock comes under control of the 
TOD-clock-sync control bit of the CPU 
which last set the clock. 



The value of the 
the clock is place 
only if the manual 
any CPU in the co 
the enable-set po 
clock control i s 
position, the valu 
clock are not chan 
are distinguished 
and 1, respectivel 



clock is changed and 
d in the stopped state 
TOD-clock control of 
nfiguration is set to 
sition. If the TOD- 
set to the secure 
e and the state of the 
ged. The two results 

by condition codes 
y. 
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When the clock is not operational, the 
value and state of the clock are not 
changed, regardless of the setting of 
the TOD-clock control, and condition 
code 3 is set. 



Special Condi ti ons 



The operand must be designated on a 
doubleword boundary; otherwise, a spec- 
ification exception is recognized. 

Resulti ng Condi ti on Code ? 

Clock value set 

1 Clock value secure 
2 

3 Clock in not-operational state 

Program Excepti ons ? 

Access (fetch, operand 2) 
Privileged operation 
Specif i cati on 



Programmi ng Note 



In an installation with more than one 
CPU, each CPU may have a separate TOD 
clock, or more than one CPU may share a 
TOD clock, depending on the model. When 
multiple TOD clocks exist, special 
procedures are required to synchronize 
the clocks. See the section "TOD-Clock 
Synchronization" in Chapter 4, 
"Control." 



Special Condi tions 



The operand must be designated on a 
doubleword boundary; otherwise, a spec- 
ification exception is recognized. 

The operation is suppressed on all 
addressing and protection exceptions. 

Condi ti on Code: The code remains 
unchanged. 

Program Exceptions ? 

Access (fetch, operand 2) 
Privileged operation 
Speci f i cati on 



SET CPU TIMER 



SPT 



D a (B a ) 



CS] 



, B208» 


B 2 


D a 



16 20 



31 



The current value of the CPU timer is 
replaced by the contents of the double- 
word designated by the second-operand 
address. 

Only those bits of the operand are set 
in the CPU timer that correspond to the 
bit positions to be updated; the 
contents of the remaining rightmost bit 
positions of the operand are ignored and 
are not preserved in the CPU timer. 



SET CLOCK COMPARATOR 



Special Condi ti ons 



SCKC 



D 9 (B 9 ) 



CS] 



•8206' 


Ba 


D a 



16 20 



31 



The current value of the clock compara- 
tor is replaced by the contents of the 
doubleword designated by the second- 
operand address. 

Only these bits of the operand are set 
in the clock comparator that correspond 
to the bit positions to be compared with 
the TOD clock; the contents of the 
remaining rightmost bit positions of the 
operand are ignored and are not 
preserved in the clock comparator. 



The operand must be designated on a 
doubleword boundary; otherwise, a spec- 
ification exception is recognized. 

The operation is suppressed on all 
addressing and protection exceptions. 



The code 



Condition Code ? 
unchanged. 

Program Exceptions ? 



Access (fetch, operand 2) 
Privileged operation 
Specification 



remains 
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SET PREFIX 



Program Except! ons : 



SPX 



D 2 (B 9 ) 



[S3 



r B210» 


B a 


D a 



16 



20 



31 



The contents of the prefix register are 
replaced by the contents of bit posi- 
tions 1-19 of the word at the location 
designated by the second-operand 
address. The translation-lookaside 
buffer (TLB) of this CPU is cleared of 
entri es. 

After the second operand is fetched* the 
value is tested for validity before it 
is used to replace the contents of the 
prefix register. Bits 1-19 of the opei — 
and with 12 rightmost zeros appended are 
used as an absolute address of the 
4K-byte new prefix area in storage. The 
prefix value is treated as a 31-bit 
address* regardless of the addressing 
mode specified by bit 32 of the current 
PSW. The 4K-byte block within the new 
prefix area is accessed; if it is not 
available in the configuration* an 
addressing exception is recognized* and 
the operation is suppressed. The access 
to the block is not subject to 
protection* however* the access may 
cause the reference bits to be set to 
ones. 

If the operation is completed* the new 
prefix is used for any interruptions 
following the execution of the instruc- 
tion and for the execution of subsequent 
instructions. The contents of bit posi- 
tions and 20-31 of the operand are 
i gnored. 

The translation-lookaside buffer (TLB) 
is cleared of entries. The TL3 appears 
cleared of its original contents* begin- 
ning with the fetching of the next 
sequential instruction. 

A serialization function is performed 
before or after the operand is fetched 
and again after the operation is 
completed. 



Access (fetch* operand 2) 
Addressing (new prefix area) 
Privileged operation 
Speci f i cat i on 



SET PSW KEY FROM ADDRESS 



SPKA D a (B a ) CS] 



f B20A* 


B 2 


D a 



16 



20 



31 



The four-bit PSW key, bits 8-11 of the 
current PSW, is replaced by bits 24-27 
of the second-operand address. 

The second-operand address is not used 
to address data; instead* bits 24-27 of 
the address form the new PSW key. Bits 
0-23 and 28-31 of the second-operand 
address are ignored. 



Special Condi ti ons 



In the problem state* the execution of 
the instruction is subject to control by 
the PSW-key mask in control register 3. 
When the bit in the PSW-key mask corre- 
sponding to the PSW-key value to be set 
is one, the instruction is executed 
successfully. When the selected bit in 
the PSW-key mask is zero, a privileged- 
operation exception is recognized. In 
the supervisor state, any value for the 
PSW key i s vali d. 



Condi ti on 
unchanged. 



Code; 



The code 



remai ns 



Program Excepti ons : 

Privileged operation (selected 
PSW-key-mask bit is zero in the 
problem state) 



Special Condi tions 



The operand must be designated on a word 
boundary* otherwise* a specification 
exception is recognized. 

The operation is suppressed on all 
addressing and protection exceptions. 



Condi tion 
unchanged 



Code: 



The code 



remains 



Programming Notes 



The format of SET PSW KEY FROM 
ADDRESS permits the program to set 
the PSW key either from the general 
register designated by the B ? field 
or from the D 2 field in the 
instruction itself. 

When one program requests another 
program to access a location desig- 
nated by the requesting program* 
SET PSW KEY FROM ADDRESS can be 
used by the called program to veri- 
fy that the requesting program is 
authorized to make this access* 



10-36 370-XA Principles of Operation 



provided the storage location of 
the called program is not protected 
against fetching. The called 
program can perform the verifica- 
tion by replacing the PSW key with 
the requesti ng-program PSW key 
before making the access and subse- 
quently restoring the called- 
program PSW key to its original 
value. Caution must be exercised, 
however, in handling any resulting 
protection exceptions since such 
exceptions may cause the operation 



to 



be 



termi nated. 



PROTECTION and 
programming notes 
tive approach to 
addresses passed 
program. 



SET SECONDARY ASN 



See TEST 

the associated 

for an alterna- 

the testing of 

by a calling 



SSAR R, 



[RRE] 



f B225» 


//////// 


R, 


//// 



16 



24 



28 31 



The ASN specified in bit positions 16-31 
of general register R t replaces the 
secondary ASN in control register 3, and 
the segment-table designation corre- 
sponding to that ASN replaces the SSTD 
in control register 7. 



Bits 16-23 and 28-31 
are ignored. 



of the instruction 



The contents of bit positions 16-31 of 
general register R t are called the new 
ASN. The contents of bit positions 0-15 
of the register are ignored. 

First the new ASN is compared with the 
current PASN. If the new ASN is equal 
to the PASN, the operation is called SET 
SECONDARY ASN to current primary 
(SSAR-cp). If the new ASN is not equal 
to the current PASN, the operation is 
called SET SECONDARY ASN with space 
switching (SSAR-ss). The SSAR-cp and 
SSAR-ss operations are depicted in the 
figure "Execution of SET SECONDARY ASN." 



SET SECONDARY 
(SSAR-ss) 



ASN wi th Space Swi tchi nq 



The new ASN is translated by means of 
the ASN translation tables, and then the 
current AX, bits 0-15 of control regis- 
ter 4, is used to test whether the 
program is authorized to access the 
specified ASN. 

The new ASN i s translated by means of a 
two-level table lookup. Bits 0-9 of the 
new ASN (bits 16-25 of the register) sre 
a 10-bit AFX which is used to select an 
entry from the ASN first table. Bits 
10-15 of the new ASN (bits 26-31 of the 
register) are a six-bit ASX which is 
used to select an entry from the ASN 
second table. The two-level lookup is 
described in the section "ASN Trans- 
lation" in Chapter 3, "Storage." The 
exceptions associated with ASN trans- 
lation are collectively called "ASN- 
translation exceptions." These 
exceptions and their priority are 
described in Chapter 6, "Interruptions." 

The AST entry obtained as a result of 
the second lookup contains the segment- 
table designation and the authority- 
table origin and length associated with 
the ASN. 

The authority-table origin from the ASN 
second-table entry is used as a base for 
a third table lookup. The current 
authorization index, bits 0-15 of 
control register 4, is used, after it 
has been checked against the authority- 
table length, as the index to locate the 
entry in the authority table. The 
authority-table lookup is described in 
the section "ASN Authorization" in Chap- 
ter 3, "Storage." 

The new ASN, bits 16-31 of general 
register R t , is placed in the SASN, bit 
positions 16-31 of control register 3. 
The segment-table designation, bits 
64-95 of the AST entry, is placed in the 
SSTD, bits 0-31 of control register 7. 

For both the SSAR-cp and SSAR-ss oper- 
ations, a serialization and checkpoint- 
synchronization function is performed 
before the operation begins and again 
after the operation is completed. 



SET SECONDARY ASN to Current Primary 
(SSAR-cp) 



Special Condi ti ons 



The new ASN replaces the SASN, bits 
16-31 of control register 3; the PSTD, 
bits 0-31 of control register 1, 
replaces the SSTD, bits 0-31 of control 
register 7; and the operation is 
completed. 



The operation is performed only when the 
ASN-translati on control, bit 12 of 
control register 14, is one and DAT is 
on. When either the ASN-translati on- 
control bit is zero or DAT is off, a 
special-operation exception is recog- 
nized. The special-operation exception 
is recognized in both the problem and 
supervisor states. 
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The priority of recognition of program 
exceptions for the instruction is shown 
in the figure "Priority of Execution: 
SET SECONDARY ASN." 



Condi ti on 
unchanged. 



Code: 



The 



code 



remains 



Program Exceptions : 

Addressing (authority-table entry* 

SSAR-ss only) 
ASN translation (SSAR-ss only) 
Secondary authority (SSAR-ss only) 
Special operation 
Trace 



1.-6. Exceptions with the same priority as the priority of program- 
interruption conditions for the general case. 

7. A Access exceptions for second instruction halfword. 

7.B Special-operation exception due to DAT being off* or the ASN- 
translation control, bit 12 of control register 14, being 
zero. 

8. A Trace exceptions. 

8.B.1 ASN-translati on exceptions (SSAR-ss only). 

8.B.2 Secondary-authority exception due to authority-table entry 
being outside table (SSAR-ss only). 

8.B.3 Addressing exception for access to authority-table entry 
(SSAR-ss only) . 

8.B.4 Secondary-authority exception due to S bit in authority- 
table entry being zero (SSAR-ss only). 



Priority of Execution: SET SECONDARY ASN 
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ASN * 



CR14 



AFTO 



(x4096) 



AFX 



(x«) 



ASX 



ASN First Table 



ASTO 



(xl6) 



(xl6) 



SET SECONDARY ASN 
Instruct! on 
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B225 f 
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R, 


// 
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R, 






ASN 



-« • *- 



CR4 
before 



AX 



PASN 



(xl/4) 



Yes I 1 No 



* + 



ASN Second Table 

(accessed for SSAR-ss only) 



SSAR-cp 



SSAR-ss 



* R 



ATO 



AX 



ATL 



STD 



(x4) 



I Authority Table 
4r (accessed for 
SSAR-ss only) 



CR1 
before 



PSTD 



(SSAR-cp only) 



LTD 



(SSAR-ss only) 



4, 4, 



CR7 
after 



SSTD 



CR3 
before 


PKM 


SASN 






* 


* 






CR3 

after 


1 




PKM 


SASN 





-*Secondary-authori ty exception if S bit is 
zero or if table length is exceeded 
(SSAR-ss only) 



R: Address is real 



Execution of SET SECONDARY ASN 
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SET STORAGE KEY EXTENDED 



Special Condi ti ons 



SSKE 



R i » R; 



CRRE3 



'B22B» 


//////// 


Ri 


R 2 



16 



24 



28 31 



The storage key for the 4K-byte block 
that i s addressed by the contents of 
general register R 3 is replaced by bits 
from general register R t . 



Bits 16-23 
i gnored. 



of the instruction are 



In the 24-bit addressing mode, bits 8-19 
of general register R a designate a 
4K-byte block in real storage, and bits 
0-7 and 20-31 of the register are 
ignored. In the 31-bit addressing mode, 
bits 1-19 of general register R a desig- 
nate a 4K-byte block in real storage, 
and bits and 20-31 of the register are 
i gnored. 

Because it is a real address, the 
address designating the storage block is 
not subject to dynamic address trans- 
lation. The reference to the storage 
key is not subject to a protection 
excepti on . 

The new seven-bit storage-key value is 
obtained from bit positions 24-30 of 
general register Ri. The contents of 
bit positions 0-23 and 31 of the regis- 
ter are ignored. 

A serialization and checkpoint- 
synchronization function is performed 
before the operation begins and again 
after the operation is completed. 



When the SSM-suppression-control bit, 
bit 1 of control register 0, is one and 
the CPU is in the supervisor state, a 
special-operation exception is recog- 
ni zed. 

The value to be loaded into the PSW is 
not checked for validity before loading. 
However, immediately after loading, a 
specification exception is recognized, 
and a program interruption occurs, if 
the contents of bit positions and 2-4 
of the PSW are not all zeros. In this 
case, the instruction is completed, and 
the instruction-length code is set to 2. 
The specification exception, which is 
listed as a program exception for this 
instruction, is described in the section 
"Early Exception Recognition" in Chapter 
6, Interruptions." This exception may 
be considered as caused by execution of 
this instruction or as occurring early 
in the process of preparing to execute 
the subsequent instruction. 

The operation is suppressed on all 
addressing and protection exceptions. 



Condi ti on 
unchanged. 



Code 



The code 



remai ns 



Program Excepti ons ? 

Access (fetch, operand 
Privileged operation 
Special operation 
Speci f i cati on 



SIGNAL PROCESSOR 



2) 



Condi ti on 
unchanged, 



Code: 



The code 



remai ns 



Program Excepti ons - 

Addressing (address 

general register 

Privileged operation 



specified by 
R 2 ) 



SET SYSTEM MASK 



SSM 



D,(B,) 



CS] 



»80» 


//////// 


B 2 


D 2 



8 



16 



20 



31 



Bits 0-7 of the current PSW are replaced 
by the byte at the location designated 
by the second-operand address. 



Bits 8-15 of 
i gnored. 



the instruction 



are 



SIGP R,,R 3 ,D a (B a ) 



[RS] 



f AE f 


Ri 


R 3 


B a 


D a 



8 



12 



16 20 



31 



An eight-bit order code and, if called 
for, a 32-bit parameter are transmitted 
to the CPU designated by the CPU address 
contained in the third operand. The 
result is indicated by the condition 
code and may be detailed by status 
assembled in the first-operand location. 



The second-operand addr 
to address data; instead 
the address contain the 
code. Bits 0-23 of th 
address are ignored, 
specifies the function 
by the addressed CPU. 
and definition of order 
the section "CPU Signali 
in Chapter 4, "Control." 



ess is not used 

, bits 24-31 of 

eight-bit order 

e second-operand 

The order code 

to be performed 

The assignment 

codes appear in 

ng and Response" 
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The 16-bit binary number contained in 
bit positions 16-31 of general register 
R 3 forms the CPU address. Bits 0-15 of 
the register are ignored. 

The general register containing the 
32-bit parameter is R t or Ri+1, whichev- 
er is the odd-numbered register. It 
depends on the order code whether a 
parameter is provided and for what 
purpose it is used. 

The operands just described have the 
following formats: 

General register designated by R,: 



Status 



31 



General register designated by R, or 
R t + 1, whichever is the odd-numbered 
regi ster : 



Parameter 



31 



General register designated by R 3 : 



//////////////// 



CPU Address 



16 



Second-operand address' 



31 



//////////////////////// 



Order 
Code 



24 



31 



A serialization function is performed 
before the operation begins and again 
after the operation is completed. 

When the order code i s accepted and no 
nonzero status is returned, condition 
code is set. When status information 
is generated by this CPU or returned by 
the addressed CPU* the status is placed 
in general register R t , and condition 
code 1 is set. 

When the access path to the addressed 
CPU is busy, or the addressed CPU is 
operational but in a state where it 
cannot respond to the order code, condi- 
tion code 2 is set. 

When the addressed CPU i s not opera- 
tional (that is, it is not provided in 
the installation, it is not in the 
configuration, it is in any of certain 



customer-engineer test modes, or its 
power is off), condition code 3 is set. 

Resulti ng Condi ti on Code : 

Order code accepted 

1 Status stored 

2 Busy 

3 Not operational 

Program Excepti ons : 

Privileged operation 



Programmi ng Notes 



1. A more detailed discussion of the 
condition-code settings for SIGNAL 
PROCESSOR is contained in the 
section "CPU Signaling and 
Response" in Chapter 4, "Control." 

2. To ensure that presently written 
programs will be executed properly 
when new facilities using addi- 
tional bits are installed, only 
zeros should appear in the unused 
bit positions of the second-operand 
address and in bit positions 0-15 
of general register R 3 . 

3. Certain SIGNAL PROCESSOR orders are 
provided with the expectation that 
they will be used primarily in 
special circumstances. Such orders 
may be implemented with the aid of 
an auxiliary maintenance or service 
processor, and, thus, the execution 
time may take several seconds. 
Unless all of the functions 
provided by the order are required, 
combinations of other orders, in 
conjunction with appropriate 
programming support, can be 
expected to provide a specific 
function more rapidly. The 
emergency-signal, external-call, 
and sense orders are the only 
orders which are intended for 
frequent use. The following orders 
are intended for infrequent use, 
and performance therefore may be 
much slower than for frequently 
used orders: restart, set prefix, 
store status at address, start, 
stop, stop and store status, and 
all the reset orders. An alterna- 
tive to the set-prefix order, for 
faster performance when the receiv- 
ing CPU is not already stopped, is 
the use of the emergency-signal or 
external-call order, followed by 
the execution of a SET PREFIX 
instruction on the addressed CPU. 
Clearing the TLB of entries is 
ordinarily accomplished more rapid- 
ly through the use of the 
emergency-signal or external-call 
order, followed by execution of the 
PURGE TLB instruction on the 
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addressed CPU, than by use 
set-prefix order. 



of the 



STORE CLOCK COMPARATOR 



STCKC D a (B a ) 



[S] 



*B207» 


B a 


D a 



16 20 



31 



The current value of the clock compara- 
tor is stored at the doubleword location 
designated by the second-operand 
address. 

Zeros are provided for the rightmost bit 
positions of the clock comparator that 
are not compared with the TOD clock. 



Special Condi tions 



The operand must be designated on a 
doubleword boundary; otherwi se, a spec- 
ification exception is recognized. 



Condi ti on 
unchanged. 



Code: 



The code 



remains 



Program Excepti ons : 

Access (store, operand 2) 
Privileged operation 
Specif i cati on 



STORE CONTROL 



STCTL R,,R 3 ,D a (B a ) 



[RSI 



«B6» 


R. 


R 3 


B 2 


D a 



8 



12 



16 



20 



31 



The set of control registers starting 
with control register R t and ending with 
control register R 3 is stored at the 
locations designated by the second- 
operand address. 

The storage area where the contents of 
the control registers are placed starts 
at the location designated by the 
second-operand address and continues 
through as many storage words as the 
number of control registers specified. 
The contents of the control registers 
are stored in ascending order of their 
register numbers, starting with control 
register R t and continuing up to and 
including control register R 3 , with 
control register following control 
register 15. The contents of the 
control registers remain unchanged. 
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Special Condi tions 



The second operand must be designated on 
a word boundary; otherwise, a specifica- 
tion exception is recognized. 



Condi ti on 
unchanged, 



Code: 



The code 



remains 



Program Excepti ons : 

Access (store, operand 2) 
Privileged operation 
Speci f icati on 



STORE CPU ADDRESS 



STAP D a (B a ) 



[S3 



»B212» 


B a 


D a 



16 



20 



31 



The CPU address by which this CPU is 
identified in a multiprocessing config- 
uration is stored at the halfword 
location designated by the second- 
operand address. 



Special Condi ti ons 



The operand must be designated on a 
halfword boundary; otherwise, a specifi- 
cation exception is recognized. 



Condi ti on Code : The code 
unchanged. 

Program Excepti ons : 

Access (store, operand 2) 
Privileged operation 
Speci f icati on 



remains 



STORE CPU ID 



STIDP D,(B,) 



[S3 



'B202' 


B a 


D a 



16 20 



31 



Information identifying the CPU is 
stored at the doubleword location desig- 
nated by the second-operand address. 

The information stored has the following 
format: 



Versi on 
Code 



CPU Identification 
Number 



31 



Model 
Number 


0000000000000000 



32 



48 



63 



Bit positions 0-7 contain the version 
code. The format and significance of 
the version code depend on the model. 

Bit positions 8-31 contain the CPU iden- 
tification number, consisting of six 
foui — bit digits. Some or all of these 
digits are selected from the physical 
serial number stamped on the CPU. The 
contents of the CPU-identification- 
number field, in conjunction with the 
model number, permit unique identifica- 
tion of the CPU. 



Bit positions 32-47 
number of the CPU. 
contain zeros. 



Special Condi ti ons 



contain the model 
Bit positions 48-63 



The operand must be designated on a 
doubleword boundary; otherwise, a spec- 
ification exception is recognised. 



Condi tion 
unchanged. 



Code: 



The code 



remai ns 



Program Excepti ons ? 

Access (store, operand 2) 
Privileged operation 
Speci f i cati on 



Proqrammi rig Notes 



The program should allow for the 
possibility that the CPU identifi- 
cation number may contain the 
digits A-F as well as the digits 
0-9. 

The CPU identification number, in 
conjunction with the model number, 
provides a unique CPU identifica- 
tion that can be used in associat- 
ing results with an individual 
machine, particularly in regard to 
functional differences, performance 
differences, and error handling. 



STORE CPU TIMER 



STPT D 2 (B 2 ) 



[S] 



'B209' 


B a 


D a 



16 



20 



31 



The current value of the CPU timer is 
stored at the doubleword location desig- 
nated by the second-operand address. 

Zeros are provided for the rightmost bit 
positions that are not updated by the 
CPU timer. 



Special Condi ti ons 



The operand must be designated on a 
doubleword boundary; otherwise, a spec- 
ification exception is recognized. 



Condi ti on 
unchanged. 



Code 



The code 



remains 



Program Excepti ons ? 

Access (store, operand 2) 
Privileged operation 
Speci f i cati on 



STORE PREFIX 



STPX 



D 9 (B 9 ) 



[S] 



, B211 f 


B a 


D a 



16 20 



31 



The contents of the prefix register are 
stored at the word location designated 
by the second-operand address. Zeros 
are provided for bit positions and 
20-31. 



Special Condi ti ons 



The operand must be designated on a word 
boundary; otherwise, a specification 
exception is recognized. 



Condi ti on 
unchanged 



Code 



The code 



remains 



Program Excepti ons : 

Access (store, operand 2) 
Privileged operation 
Speci f i cati on 
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STORE THEN AND SYSTEM MASK 



STNSM D,(B,),I 2 



CSI] 



'AC 


It 


B, 


D, 



8 



16 



20 



31 



Bits 0-7 of the current PSW are stored 
at the first-operand location. Then the 
contents of bit positions 0-7 of the 
current PSW are replaced by the logical 
AND of their original contents and the 
second operand. 



Special Condi ti ons 



The operation is suppressed on address- 
ing and protection exceptions. 

Condi t ion Code : The code remains 
unchanged. 

Program Excepti ons ? 

Access (store* operand 1) 
Privileged operation 



Programmi ng Note 



STORE THEN AND SYSTEM MASK permits the 
program to set selected bits in the 
system mask to zeros while retaining the 
original contents for later restoration. 
For example, it may be necessary that a 
program, which has no record of the 
present status, disable program-event 
recording for a few instructions. 



specification exception is recognized, 
and a program interruption occurs, if 
the contents of bit positions and 2-4 
of the PSW are not all zeros. In this 
case, the instruction is completed, and 
the instruction-length code is set to 2. 
The specification exception, which is 
listed as a program exception for this 
instruction, is described in the section 
"Early Exception Recognition" in Chapter 
6, "Interruptions." This exception may 
be considered as caused by execution of 
this instruction or as occurring early 
in the process of preparing to execute 
the subsequent instruction. 

The operation is suppressed on address- 
ing and protection exceptions. 



Condi ti on Code : The code 
unchanged. 

Program Excepti ons : 

Access (store, operand 1) 
Privileged operation 
Speci f i cati on 



remains 



Programmi ng Note 



STORE THEN OR SYSTEM MASK permits the 
program to set selected bits in the 
system mask to ones while retaining the 
original contents for later restoration. 
For example, the program may enable the 
CPU for I/O interruptions without having 
available the current status of the 
external-mask bit. 



TEST BLOCK 



TB 



R i , R; 



CRRE] 



STORE THEN OR SYSTEM MASK 



STOSM D,(B,),I a 



[SI] 



'AD' 


I* 


B, 


D, 



8 



16 20 



31 



Bits 0-7 of the current PSW are stored 
at the first-operand location. Then the 
contents of bit positions 0-7 of the 
current PSW are replaced by the logical 
OR of their original contents and the 
second operand. 



Special Condi ti ons 



The value to be loaded into the PSW is 
not checked for validity before loading. 
However, immediately after loading, a 



'B22C 


//////// 


R, 


R a 



16 



24 



28 31 



The storage locations and storage key of 

a 4K-byte block are tested for 

usability, and the result of the test is 
indicated in the condition code. The 

test for usability is based on the 

susceptibility of the block to the 

occurrence of invalid checking-block 
code. 



Bits 16-23 
i gnored. 



of the instruction are 



The block tested is addressed by the 

contents of general register R a . The 

contents of general register R t are 
i gnored. 

A complete testing operation is neces- 
sarily performed only when the initial 
contents of general register are zero. 
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The contents 
set to zero 
operati on. 



of general register are 
at the completion of the 



If the block is found 
4K bytes of the bloc 
zeros* the contents o 
are unpredictable, and 
is set. If the bloc 
unusable, the data an 
are set, as far as i 
model, to a value sue 
fetches to the area 
machine-check conditi 
code 1 is set. 



to be usable, the 
k are cleared to 
f the storage key 
condition code 
k i s found to be 
d the storage key 
s possible by the 
h that subsequent 

do not cause a 
on, and condition 



In the 24-bit addressing mode, bits 8-19 
of general register R a designate a 
4K-byte block in real storage, and bits 
0-7 and 20-31 of the register are 
ignored. In the 31-bit addressing mode, 
bits 1-19 of general register R 2 desig- 
nate a 4K-byte block in real storage, 
and bits and 20-31 of the register are 
i gnored. 



The address of 
address, and the 
designated by the 
are not subject 
page protection, 
does apply. The 
on addressing and 
If termination 
code and the cont 
ter are unpred 
of the storage bl 
storage key are 
exceptions occur 



the block is a real 

accesses to the block 

second-operand address 

to key-controlled and 

Low-address protection 

operation is terminated 

protection exceptions. 

occurs, the condition 

ents of general regi s- 

ictable. The contents 

ock and its associated 

not changed when these 



Depending on the model, the test for 
usability may be performed (1) by alter- 
nately storing and reading out test 
patterns to the data and storage key in 
the block or (2) by reference to an 
internal record of the usability of the 
blocks which are available in the 
configuration, or (3) by using a combi- 
nation of both mechanisms. 



In models in wh 
used, the block 
if a solid fai 
detected, or if 
the block have 
implemented by 
models, depend 
attempts to sto 
Thus, if block 
store occurs, 1 
or may not be i 



i ch an internal 
i s i ndi cated a 

lure has been 
intermittent f 
exceeded the 
the model. 

ing on the 

re may or may 
is not usabl 

ow-address prot 

ndi cated. 



of operation, oth 
the condition code 
the contents of g 
contain a record 
mediate steps, 
resumed after 
condition code 
contents of gener 
used to determine 



er than the last one, 
! is unpredictable, and 
leneral register may 
f the state of i nter- 
When execution is 
n interruption, the 
s ignored, but the 
al register may be 
the resumption point. 

If (1) TEST BLOCK is executed with an 
initial value other than zero in general 
register 0, or (2) the interrupted 
instruction is resumed after an intei — 
ruption with a value in general register 
other than the value which was present 
at the time of the interruption, or 
(3) the block is accessed by another CPU 
or by the channel subsystem during the 
execution of the instruction, then the 
contents of the storage block, its asso- 
ciated storage key, and general register 
are unpredictable, along with the 
resultant condition-code setting. 

Invalid checking-block-code errors 
initially found in the block or encount- 
ered during the test do not normally 
result in machine-check conditions. The 
test-block function is implemented in 
such a way that the frequency of 
machine-check interruptions due to the 
instruction execution is not 
significant. However, if, during the 
execution of TEST BLOCK for an unusable 
block, that block is accessed by another 
CPU (or by the channel subsystem), error 
conditions may be reported both to this 
CPU and to the other CPU (or to the 
channel subsystem) . 

A serialization function is performed 
before the block is accessed and again 
after the operation is completed (or 
partially completed). 

The priority of the recognition of 
exceptions and condition codes is shown 
in the figure "Priority of Execution: 
TEST BLOCK." 



record l s 
s unusable 


R 


esulti r 


ig Condition Code: 


previ ously 

ailures in 

threshold 

In such 


1 
1 



1 
2 


Block usable 
Block not usable 


cri teri a, 




3 


— 


not occur, 
e, and no 
ection may 


P 


roqram 


Excepti ons: 



In models in which test patterns are 
used, TEST BLOCK may be i nterrupti ble. 
When an interruption occurs after a unit 



Addressing (fetch and store, oper- 
and 2) 

Privileged operation 

Protection (store, operand 2, low- 
address protection only) 
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1.-6. Exceptions with the same pri- 
ority as the priority of pro- 
gram-interruption conditions 
for the general case. 

7. A Access exceptions for second 
instruction halfword. 

7.B Privileged-operation exception. 

8. Addressing exception due to 
block not being available in 
the conf i gurati on.* 

9. A Condition code 1, block not 
usable. 

9.B Protection exception due to 
low-address protection. x 

10. Condition code 0, block usable 
and set to zeros. 



Explanat i on : 



The operation is terminated on 
addressing and protection excep- 
tions, and the condition code may 
be unpredictable. 



Priority of Execution: TEST BLOCK 



4. 



externally generated error or an 
indirect storage error.) This 
procedure should be followed 
regardless of whether the 
i ndi rect-storage-error i ndi cat i on 
i s reported. 



The model 
successful 
from a bio 
executed, 
should ta 
precaut i on 
unusable bl 
program sho 
frame real 
block in 
page-table 



may or 
in remov 
ck when 

The pro 
ke eve 
to avoid 
ock. Fo 
uld not 

address 
an attac 
entry. 



may not be 
ing the errors 

TEST BLOCK is 
gram therefore 
ry reasonable 

referencing an 
r example, the 
place the page- 
of an unusable 
hed and valid 



On some mode 
be reported 
the block is 
program. Wh 
reported for 
a block whi 
unusable by 
possible th 
EXTENDED may 
TEST BLOCK i 
age key. 



Is, machine checks may 
for a block even though 

not referenced by the 
en a machine check is 

a storage-key error in 
ch has been marked as 
the program, it is 
at SET STORAGE KEY 

be more effective than 
n validating the stor- 



The storage-operand references for 
TEST BLOCK may be multiple-access 
references. (See the section 
"Storage-Operand Consistency" in 
Chapter 5, "Program Execution.") 



Programmi ng Notes 



TEST PROTECTION 



1. The execution of TEST BLOCK on most 
models is significantly slower than 
that of the MOVE LONG instruction 
with padding; therefore, the 
instruction should not be used for 
the normal case of clearing 
storage. 

2. The program should use TEST BLOCK 
at initial program loading and as 
part of the vary-storage-onli ne 
procedure to determine if blocks of 
storage exist which should not be 
used. 

3. The program should use TEST BLOCK 
when an uncorrected error is 
reported in either the data or 
storage key of a block. This is 
because in the execution of TEST 
BLOCK the attempt is made, as far 
as is possible on the model, to 
leave the contents of a block in a 
state such that subsequent 
prefetches or unintended references 
to the block do not cause machine- 
check conditions. The program may 
use the resulting condition code in 
this case to determine if the block 
can be reused. (The block could be 
indicated as usable if, for 
example, the error were an 



TPROT D,(B,),D a (B a ) 



[SSE1 



'E501' 



B t 



D t 
-/— 



-/ 1 

D a 
./ I 



16 



20 



32 



36 47 



The location designated by the first- 
operand address is tested for protection 
exceptions using the access key speci- 
fied in bits 24-27 of the second-operand 
address. 

The second-operand address is not used 
to address data; instead, bits 24-27 of 
the address form the access key to be 
used in testing. Bits 0-23 and 28-31 of 
the second-operand address are ignored. 

The first-operand address is a logical 
address and thus is subject to trans- 
lation when DAT is on. When DAT is on 
and the f i rst-operand address cannot be 
translated because of a situation that 
would normally cause a page-translation 
or segment-translation exception, the 
instruction is completed by setting 
condition code 3. 

When translation of the first-operand 
address can be completed, or when DAT is 
off, the storage key for the block 
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designated by the first 
is tested against the a 
fied in bits 24-27 of th 
address, and the condit 
to indicate whether s 
accesses are permitted 
consideration all appli 
mechanisms. Thus, for 
address protection is ac 
first-operand effective 
than 512, then a store 
permitted. Page protec 
protection override are 
account . 



-operand address 
ccess key speci- 
e second-operand 
i on code i s set 
tore and fetch 
taking into 
cable protection 
example, if low- 
tive and if the 
address i s less 
access i s not 
tion and fetch- 
also taken into 



The contents of storage, including the 
change bit, are not affected. Depending 
on the model, the reference bit for the 
first-operand address may be set to one, 
even for the case in which the location 
is protected against fetching. 



Speci al Condi ti ons 



When DAT is on, an addressing exception 
is recognized when the address of the 
segment-table entry, the page-table 
entry, or the operand real address after 
translation designates a location which 
is not available in the configuration. 
Also, when DAT is on, a translation- 
specification exception is recognized 
when the segment-table entry or page- 
table entry has a format error. When 
DAT is off, only the addressing excep- 
tion due to the operand real address 
applies. For all of these cases, the 
operation is suppressed. 



Resulti ng Condi ti on Code : 




stori ng 



Fetching permitted; 
permi tted 

1 Fetching permitted; storing not 
permi tted 

2 Fetching not permitted; storing 
not permitted 

3 Translation not available 

Program Excepti ons ? 

Addressing (operand 1) 
Privileged operation 
Translation specification 



Programmi ng Notes 



TEST PROT 
to check 
passed fr 
out incu 
The inst 
code to 
or stori 
locati on 
operand a 
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erati on 



ECTION 
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ruct i on 
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all o 
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gram 
ress 
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ti on 
hi ng 
the 
rst- 
i on . 
si d- 
ti on 



mechanisms in 
key-controlled, 
protection overri 
address protection, 
since segment trans 
translation may 
substitute for 
violation, these 
used to set the 
rather than cause 
ti on. 



the machine: 
page, fetch 

de, and low- 
Addi ti onally, 

lation and page 

be a program 
a protection 
situations are 
condition code 

a program excep- 



2. See the programming notes under SET 
PSW KEY FROM ADDRESS for more 
details and for an alternative 
approach to testing validity of 
addresses passed by a calling 
program. The approach using TEST 
PROTECTION has the advantage of a 
test which does not result in 
interruptions; however, the test 
and use are separated in time and 
may not be accurate if the possi- 
bility exists that the storage key 
of the location in question can 
change between the time it is test- 
ed and the time it is used. 

3. In the handling of dynamic address 
translation, TEST PROTECTION is 
similar to LOAD REAL ADDRESS in 
that the instructions do not cause 
page-translation and segment- 
translation exceptions. Instead, 
these situations are indicated by 
means of a condition-code setting. 
Situations which result in condi- 
tion codes 1, 2, and 3 for LOAD 
REAL ADDRESS result in condition 
code 3 for TEST PROTECTION. The 



instructions also 

other respects. 

address of TEST 

logical address 

subject to translation when DAT 

off. The second-operand address 



differ in several 
The first-operand 
PROTECTION is a 
and thus is not 
i s 
of 



LOAD REAL ADDRESS is a virtual 
address which is always translated. 
TEST PROTECTION may use the TLB for 
translation of the address, whereas 
LOAD REAL ADDRESS does not use the 
TLB. (LOAD REAL ADDRESS is the 
only instruction which must perform 
translation without use of the 
TLB.) 

When DAT is off for LOAD REAL 
ADDRESS, the translation-specifica- 
tion exception for an invalid value 
of bits 8-12 of control register 
occurs after instruction fetching 
as part of the execution portion of 
the instruction. This situation 
cannot occur for TEST PROTECTION 
since the operand address is a 
logical address and does not result 
in examination of control register 
when DAT is off. When DAT is on, 
the exception would be recognized 
during instruction fetching. Since 
the instruction-fetching portion of 
an instruction is common for all 
instructions, descriptions of 
access exceptions associated with 
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instruction fetching do not appear 
in the individual instruction defi- 
ni ti ons. 



TRACE 



TRACE R,,R 3 ,D a (B 2 ) 



ERS3 



f 99 f 


R, 


R 3 


B a 


D a 



8 



12 



16 



20 



31 



When explicit tracing is on (bit 31 of 
control register 12 is one), the second 
operand, which is a 32-bit word in stoi — 
age, is fetched, and bit of the word 
is examined. If bit of the second 
operand is zero, a trace entry is formed 
at the real-storage location designated 
by control register 12. 

If explicit tracing is off (bit 31 of 
control register 12 is zero), or if bit 
of the second operand is one, no trace 
entry is formed, and no trace exceptions 
are recognized. 

The trace entry is composed of an 
entry-type identifier, a count of the 
number of general registers whose 
contents are placed in the entry, bits 
16-63 of the TOD clock, the second oper- 
and, and the contents of a range of 
general registers. The general regis- 
ters are stored in ascending order of 
their register numbers, starting with 
general register R t and continuing up to 
and including general register R 3 , with 
general register following general 
register 15. The trace table and the 
trace-entry formats are described in the 
section "Tracing" in Chapter 4, 
"Control." 



When a trace entry is made, a serializa- 
tion and checkpoint-synchronization 
function is performed before the opera- 
tion begins and again after the opera- 
tion is completed. 



Special Condi tions 



A privileged-operation exception is 

recognized in the problem state, even 

when explicit tracing is off or bit of 
the second operand is one. 

The second operand must be designated on 
a word boundary; otherwise, a specifica- 
tion exception is recognized. It is 
unpredictable whether the specification 
exception is recognized when explicit 
tracing is off. 

It is unpredictable whether access 
exceptions are recognized for the second 
operand when explicit tracing is off. 



Condi ti on 
unchanged. 



Code: 



The code remains 



Program Excepti ons : 



Access (fetch, operand 2) 
Privileged operation 
Speci f i cati on 
Trace 



Programmi ng Note 



Bits 1-15 of the second operand &re 
reserved for model-dependent functions 
and should therefore be set to zeros. 
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CHAPTER 11. MACHINE-CHECK HANDLING 
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Error Checking and Correction 

CPU Retry 

Effects of CPU Retry 

Checkpoint Synchronization 

Handling of Machine Checks during Checkpoint 
Synchronization 

Checkpoint-Synchronization Operations 

Checkpoint-Synchronization Action 

Channel-Subsystem Recovery 

Unit Deletion 

Handling of Machine Checks 

Validation 

Invalid CBC in Storage 

Programmed Validation of Storage 

Invalid CBC in Storage Keys 

Invalid CBC in Registers 

Check-Stop State 

System Check Stop 

Machine-Check Interruption 
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Repressible Conditions 

Interruption Action 

Point of Interruption 

Machi ne-Check-Interrupti on Code 
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Vectoi — Facility Failure 

Degradat i on 
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Channel Report Pendi ng 
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Synchronous Machine-Check-Interruption Conditions 
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Storage Error Uncorrected 

Storage Error Corrected 

Storage-Key Error Uncorrected 

Storage Degradati on 

Machine-Check Interruption-Code Validity Bits ... 

PSN-MWP Validity 

PSW Mask and Key Validity 

PSW Program-Mask and Condition-Code Validity .. 

PSUI-Instruct i on-Address Validity 

Failing-Storage-Address Validity 

External-Damage-Code Validity 
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Indirect Storage Error 
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The machine-check-handling mechanism 
provides extensive equipment-malfunction 
detection to ensure the integrity of 
system operation and to permit automatic 
recovery from some malfunctions. Equip- 
ment malfunctions and certain external 
di sturbances are reported by means of a 
machine-check interruption to assist in 
program-damage assessment and recovery. 
The interruption supplies the program 
with information about the extent of the 
damage and the location and nature of 
the cause. Equipment malfunctions* 
errors, and other situations which can 
cause machine-check interruptions are 
referred to as machine checks. 



MACHINE-CHECK DETECTION 



Machi ne-check-detect i on 
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group of check bits is included 

detection of multiple errors, 

error correction, or both. 



For checking purposes, the entire 
contents of a checking block, including 
the redundancy, is called a checking- 
block code (CBC). When a CBC completely 
meets the checking requirements (that 
is, no failure is detected), it is said 
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to be valid. When both detection and 
correction are provided and a CBC is not 
valid but satisfies the checking 
requirements for correction (the failure 
is correctable), it is said to be near- 
valid. When a CBC does not satisfy the 
checking requirements (the failure is 
uncorrectable), it is said to be 
invali d. 



CORRECTION OF MACHINE MALFUNCTIONS 



Four mechanisms may be used to provide 
recovery from machine-detected malfunc- 
tions: error checking and correction, 
CPU retry, channel-subsystem recovery, 
and unit deletion. 

Machine failures which are corrected 
successfully may or may not be reported 
as machine-check interruptions. If 
reported, they are system-recovery 
conditions, which permit the program to 
note the cause of CPU delay and to keep 
a log of such incidents. 



ERROR CHECKING AND CORRECTION 



When sufficient redundancy 
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Depending on the model and the portion 
of the machine in which ECC is applied, 
correction may be reported as system 
recovery, or no report may be given. 

Uncorrected errors in storage and in the 
storage key may be reported, along with 
a failing-storage address, to indicate 
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where the error occurred. Depending on 
the situation/ these errors may be 
reported along with system recovery or 
with the damage or backup condition 
resulting from the error. 



CPU RETRY 



In some models, information about some 
portion of the state of the machine is 
saved periodically. The point in the 
processing at which this information is 
saved is called a checkpoint. The 
information saved is referred to as the 
checkpoint information. The action of 
saving the information is referred to as 
establishing a checkpoint. The action 
of discarding previously saved informa- 
tion is called invalidation of the 
checkpoint information. The length of 
the interval between establishing check- 
points is model-dependent. Checkpoints 
may be established at the beginning of 
each instruction or several times within 
a single instruction, or checkpoints may 
be established less frequently. 

Subsequently, this saved information may 
be used to restore the machine to the 
state that existed at the time when the 
checkpoint was established. After 
restoring the appropriate portion of the 
machine state, processing continues from 
the checkpoint. The process of restoi — 
ing to a checkpoint and then continuing 
is called CPU retry. 

CPU retry may be used for machine-check 
recovery, to effect nullification and 
suppression of instruction execution 
when certain program interruptions 
occur, and in other model-dependent 
si tuati ons. 



Effects of CPU Retry 



CPU retry is, in general, performed so 
that there is no effect on ths» program. 
However, change bits which have been 
changed from zeros to ones are not 
necessarily set back to zeros. As a 
result, change bits may appear to be set 
to ones for blocks which would have been 
accessed if restoring to the checkpoint 
had not occurred. If the path taken by 
the program is dependent on information 
that may be changed by another CPU or by 
a channel program or i f an interruption 
occurs, then the final path taken by the 
program may be different from the earli- 
er path; therefore, change bits may be 
ones because of stores along a path 
apparently never taken. 



Checkpoi nt Synchroni zati on 



Checkpoint synchronization consists 
the following steps. 



l n 



The CPU operation is delayed until 
all conceptually previous accesses 
by thi s CPU to storage have been 
completed, both for purposes of 
machine-check detection and as 
observed by other CPUs and by chan- 
nel programs. 



2. 



All previous 
are canceled, 



checkpoints, if any, 



Optionally, a new checkpoint is 
established. The CPU operation is 
delayed until all of these actions 
appear to be completed, as observed 
by other CPUs and by channel 
programs. 



Handli ng of Machi ne Checks duri ng Check- 
poi nt Svnchroni zati on 



When, in the process of completing all 
previous stores as part of the 
checkpoint-synchronization action, the 
machine is unable to complete all stores 
successfully but can successfully 
restore the machine to a previous check- 
point, processing backup is reported. 

Ulhen, in the process of completing all 
stores as part of the checkpoint- 
synchronization action, the machine is 
unable to complete all stores success- 
fully and cannot successfully restore 
the machine to a previous checkpoint, 
the type of machine-check-interruption 
condition reported depends on the origin 
of the store. Failure to successfully 
complete stores associated with instruc- 
tion execution may be reported as 
instruction-processing damage, or some 
less critical machine-check-interruption 
condition may be reported with the 
storage-logical-validity bit set to 
zero. A failure to successfully 
complete stores associated with the 
execution of an interruption, other than 
program or supervisor call, is reported 
as system damage. 

Ulhen the machine check occurs as part of 
a checkpoint-synchronization action 
before the execution of an instruction, 
the execution of the instruction is 
nullified. Ulhen it occurs before the 
execution of an interruption, the intei — 
ruption condition, if the interruption 
is external, I/O, or restart, is held 
pending. If the checkpoint- 
synchronization operation was a 
machine-check interruption, then along 
with the originating condition, either 
the storage-logical-validity bit is set 
to zero or instruction-processing damage 
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is also reported. Program interrup- 
tions, if any, are lost. 



Checkpoi nt-Svnchroni zat i on Qperati ons 



All interruptions and the execution of 
certain instructions cause a check- 
point-synchronization action to be 
performed. The operations which cause a 
checkpoint-synchronization action ar& 
called checkpoint-synchronization opei — 
ations and include: 

• CPU reset 

• All interruptions: external, I/O, 
machine check, program, restart, 
and supervisor call 

The BRANCH ON CONDITION (BCR) 
instruction with the M t and R a 
fields containing all ones and all 
zeros, respectively 

• The instructions LOAD PSW, SET 
STORAGE KEY EXTENDED, and SUPERVI- 
SOR CALL 

• All I/O instructions 

The instructions MOVE TO PRIMARY, 
MOVE TO SECONDARY, PROGRAM CALL, 
PROGRAM TRANSFER, SET ADDRESS SPACE 
CONTROL, and SET SECONDARY ASN 

• The three trace functions: branch 
tracing, ASN tracing, and explicit 
traci ng 



Note 



check interruptions, a checkpoint- 
synchronization action is also performed 
before the interruption. The fetch 
access to the new PSW may be performed 
either before or after the first 
checkpoint-synchronization action. The 
store accesses and the changing of the 
current PSW associated with the inter- 
ruption are performed after the first 
checkpoint-synchronization action and 
before the second. 

For all checkpoint-synchronization in- 
structions except BRANCH ON CONDITION 
(BCR), I/O instructions, and SUPERVISOR 
CALL, checkpoint-synchronization actions 
are performed before and after the 
execution of the instruction. For BCR, 
only one checkpoint-synchronization 
action is necessarily performed, and it 
may be performed either before or after 
the instruction address is updated. For 
SUPERVISOR CALL, a checkpoint- 
synchronization action is performed 
before the instruction is executed, 
including the updating of the instruc- 
tion address in the PSW. The 
checkpoint-synchronization action taken 
after the supervisot — call interruption 
is considered to be part of the inter- 
ruption action and not part of the 
instruction execution. For I/O 
instructions, a checkpoint-synchroniza- 
tion action is always performed before 
the instruction is executed and may or 
may not be performed after the instruc- 
tion is executed. 

The three trace functions — branch 
tracing, ASN tracing, and explicit 
tracing -- cause checkpoint-synchroniza- 
tion actions to be performed before the 
trace action and after completion of the 
trace action. 



The instructions which &r& defined to 
cause the checkpoint-synchronization 
action invalidate checkpoint information 
but do not necessarily establish a new 
checkpoint. Additionally, the CPU may 
establish a checkpoint between any two 
instructions or units of operation, or 
within a single unit of operation. 
Thus, the point of interruption for the 
machine check is not necessarily at an 
instruction defined to cause a 
checkpoi nt-synchroni zat i on act i on . 



Checkpoi nt-Svnchroni zat i on Act i on 
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CHANNEL-SUBSYSTEM RECOVERY 



When errors are detected in the channel 
subsystem, the channel subsystem 
attempts to analyze and recover the 
internal state associated with the vari- 
ous channel-subsystem functions and the 
state of the channel subsystem and vari- 
ous subchannels. This process, which is 
called channel-subsystem recovery, may 
result in a complete recovery or may 
result in the termination of one or more 
I/O operations and the clearing of the 
affected subchannels. Special channel- 
report -pendi ng machi ne-check-i nterrup- 
ti on conditions may be generated to 
indicate to the program the status of 
the channel-subsystem recovery. 

Malfunctions associated with the I/O 
operations, depending on the severity of 
the malfunction, may be reported by 
means of the I/O-i nterrupti on mechanism 
or by means of the channel-report- 
pending and channel-subsystem-damage 
machi ne-check-i nterrupti on conditions. 
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UNIT DELETION 



In some models, malfunctions in certain 
units of the system can be circumvented 
by discontinuing the use of the unit. 
Examples of cases where unit deletion 
may occur include the disabling of all 
or a portion of a cache or of a 
translation-lookaside buffer (TLB). 
Unit deletion may be reported as a 
degradat i on machi ne-check-i nterrupti on 
condi ti on. 



HANDLING OF MACHINE CHECKS 



A malfunction detected as part of an I/O 
operation may cause a machine-check- 
interruption condition, an I/O-error 
condition, or both. I/O-error condi- 
tions are indicated by an I/O inter- 
ruption or by the appropriate 
condition-code setting during the 
execution of an I/O instruction. When 
the machine reports a failing-storage 
location detected during an I/O opera- 
tion, both I/O-error and machine-check 
conditions may be indicated. The I/O- 
error condition is the primary 
indication to the program. The 
machine-check condition is a secondary 
indication, which is presented as system 
recovery together with a failing-storage 
address. 



A machine check is caused by a machine 
malfunction and not by data or 
instructions. This is ensured during 
the power-on sequence by initializing 
the machine controls to a valid state 
and by placing valid CBC in the CPU 
registers, in the storage keys, and in 
main storage. 

Designation of an unavailable component, 
such as a storage location, subchannel, 
or I/O device, does not cause a 
machine-check indication. Instead, such 
a condition is indicated by the appro- 
priate program or I/O interruption or 
condition-code setting. In particular, 
an attempt to access a storage location 
which is not in the configuration, or 
which has power off at the storage unit, 
results in an addressing exception when 
detected by the CPU and does not genei — 
ate a machine-check condition, even 
though the storage location or its asso- 
ciated storage key has invalid CBC. 
Similarly, if the channel subsystem 
attempts to access such a location, an 
I/O— i nterrupti on condition indicating 
program check i s generated rather than a 
machine-check condition. 
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When a machine malfunction is detected, 
the action taken depends on the model, 
the nature of the malfunction, and the 
situation in which the malfunction 
occurs. Malfunctions affecting 
operator-facility actions may result in 
machine checks or may be indicated to 
the operator. Malfunctions affecting 
certain other operations such as SIGNAL 
PROCESSOR may be indicated by means of a 
condition code or may result in a 
machi ne-check-i nterrupti on condi ti on. 



Certain malfunctions detected as part of 
I/O instructions and I/O operations are 
reported by means of special machine- 
check conditions called I/O machine- 
check conditions. Thus, malfunctions 
detected as part of an operation which 
i s I/O related may be reported, depend- 
ing on the error, in any of three ways: 
I/O error condition, I/O machine-check 
condition, or non-1/0 machine-check 
condition. In some cases the definition 
requi res the error to be reported by 
only one of these mechanisms; in other 
cases, any one, or in some cases, more 
than one, may be indicated. 



Programmi ng Note 



Although the definition for machine- 
check conditions is that they &re caused 
by machine malfunctions and not by data 
and instructions, there are certain 
unusual situations in which machine- 
check conditions are caused by events 
which are not machine malfunctions. Two 
examples follow: 

1. In some cases, the channel-report- 
pendi ng machi ne-check-i nterrupti on 
condition indicates a non-error 
situation. For example, this 
condition is generated at the 
completion of the function speci- 
fied by RESET CHANNEL PATH. 

2. Improper use of DIAGNOSE may result 
in machine-check conditions. 
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Invalid CBC is preserved as invalid when 
information with invalid CBC is fetched 
or when an attempt is made to update 
only a portion of the checking block. 
When an attempt is made to replace the 
contents of the entire checking block 
and the block contains invalid CBC* it 
depends on the operation and the model 
whether the block remains with invalid 
CBC or is replaced. An operation which 
replaces the contents of a checking 
block with valid CBC* while ignoring the 
current contents* is called a validation 
operation. Validation is used to place 
a valid CBC in a register or at a 
location which has an intermittent or 
externally generated error. 

Validating a checking block does not 
ensure that a valid CBC will be observed 
the next time the checking block is 
accessed. If the failure is solid* 
validation is effective only if the 
information placed in the checking block 
is such that the failing bits are set to 
the value to which they fail. If an 
attempt is made to set the bits to the 
state opposite to that in which they 
fail* then the validation will not be 
effective. Thus* for a solid failure* 
validation is only useful to eliminate 
the error condition* even though the 
underlying failure remains* thereby 
reducing the exposure to additional 
reports. The locations* however* cannot 
be used* since invalid CBC will result 
from attempts to store other values at 
the location. For an intermittent fail- 
ure* however* validation is useful to 
restore a valid CBC such that a subse- 
quent partial store into the checking 
block will be permitted. (A partial 
store is a store into a checking block 
without replacing the entire checking 
block. ) 

When a checking block consists of multi- 
ple bytes in storage* or multiple bits 
in CPU registers* the invalid CBC can be 
made valid only when all of the bytes or 
bits are replaced simultaneously. 
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When an error occurs in a checking 
block* the original information 
contained in the checking block should 
be considered lost even after 
validation. Automatic register vali- 
dation leaves the contents 
unpredictable. Programmed and manual 
validation of checking blocks causes the 
contents to be changed explicitly. 



Programming Note 



The machine-check-interruption handler 
must assume that the registers require 
validation. Thus* each register should 
be loaded* using an instruction defined 
to validate* before the register is used 
or stored. 



INVALID CBC IN STORAGE 



The size of the checking block in stor- 
age depends on the model but is never 
more than 4K bytes. 

When invalid CBC is detected in storage* 
a machine-check condition may occur; 
depending on the circumstances* the 
machine-check condition may be system 
damage* instruction-processing damage* 
or system recovery. If the invalid CBC 
is detected as part of the execution of 
a channel program* the error is reported 
as an I/0-error condition. When a CCW, 
indirect-data-address word* or data is 
prefetched from storage* is found to 
have invalid CBC* but is not used in the 
channel program, the condition is not 
reported as an I/0-error condition. The 
condition may or may not be reported as 
a machine-check-interruption condition. 
Invalid CBC detected during accesses to 
storage for other than CPU-related 
accesses may be reported as system 
recovery with storage error uncorrected 
indicated* since the primary error indi- 
cation is reported by some other means. 

When the storage checking block consists 
of multiple bytes and contains invalid 
CBC* special storage-validation proce- 
dures are generally necessary to restore 
or place new information in the checking 
block. Validation of storage is 
provided with the manual load-clear and 
system-reset-clear operations and is 
also provided as a program function. 
Programmed storage validation is done a 
block at a time* by executing the privi- 
leged instruction TEST BLOCK. Manual 
storage validation by clear reset vali- 
dates all blocks which are available in 
the configuration. 

A checking block with invalid CBC is 
never validated unless the entire 
contents of the checking block are 
replaced. An attempt to store into a 
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Programmi ng Note 



Machine-check conditions may be reported 
for prefetched and unused data. Depend- 
ing on the model, such situations may, 
or may not, be successfully retried. 
For example, a BRANCH AND LINK (BALR) 
instruction which specifies an R 2 field 
of zero will never branch, but on some 
models a prefetch of the location desig- 
nated by register zero may occur. 
Access exceptions associated with this 
prefetch will not be reported. However, 
if an invalid checking-block code is 
detected, CPU retry may be attempted. 
Depending on the model, the prefetch may 
recur as part of the retry, and thus the 
retry will not be successful. Even when 
the CPU retry is successful, the 
performance degradation of such a retry 
is significant, and system recovery may 
be presented, normally with a failing- 
storage address. To avoid continued 
degradation, the program should initiate 
proceedings to eliminate use of the 
location and to validate the location. 



Programmed Val i dati on of Storage 



Provided that an invalid CBC does not 
exist in the storage key associated with 



INVALID CBC IN STORAGE KEYS 



Depending on the model, each storage key 
may be contained in a single checking 
block, or the access-control and fetch- 
protection bits and the reference and 
change bits may be in separate checking 
blocks. 
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Action Taken on Invalid CBC 



Type of Reference 



SET STORAGE KEY 
EXTENDED 

INSERT STORAGE KEY 
EXTENDED 

RESET REFERENCE BIT 
EXTENDED 

INSERT VIRTUAL STORAGE 
KEY or TEST PROTEC- 
TION 

CPU prefetch (informa- 
tion not used) 

Channel-program pre- 
fetch (information 
not used) 

Fetch, nonzero access 
key 

Store 1 , nonzero access 
key 

Fetch, zero access 
key 4 

Store 1 , zero access 
key 4 



For Access-Control and 
Fetch-Protection Bits 



Complete; validate. 

PD; preserve. 

PD or complete; 
preserve. 

PD; preserve. 



CPF; preserve. 
IPF; preserve. 

MC; preserve. 

MC 2 ; preserve. 

MC or complete; 
preserve. 

MC or complete; 
preserve. 



For Reference and 
Change Bits 



Complete; validate. 
PD; preserve. 
PD; preserve. 
CPF; preserve. 

CPF; preserve. 
IPF; preserve. 



MC or complete; 
preserve. 

MC and preserve; or 
complete 3 and correct 

MC or complete; 
preserve. 

MC and preserve; or 
complete 3 and correct 



Explanat i on : 



Complete 



CPU virtual- and logical-address store accesses are sub- 
ject to page protection. When the page-protection bit 
is one, the location will not be changed; however, the 
machine may indicate a machine-check condition if the 
storage key or the data itself has invalid CBC. 

The contents of the main-storage location are not changed. 

The contents of the reference and change bits &re set 
to ones if the "complete" action is taken. 

The action shown for an access key of zero is also appli- 
cable to references to which key-controlled protection 
does not apply. 

The condition does not cause termination of the execution 
of the instruction and, unless an unrelated condition pro- 
hibits it, the execution of the instruction is completed, 
ignoring the error condition. No machine-check-damage 
conditions are generated, but a system-recovery condition 
may be generated. 



Invalid CBC in Storage Keys (Part 1 of 2) 
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Explanation (Continued): 



Correct The reference and change bits are set to ones with valid 
CBC. 



Preserve The contents of the entire checking block having 
CBC are left unchanged. 



i nvali d 



Validate The entire key is set to the new value with valid CBC 



CPF 



IPF 



MC 



PD 
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in the storage key for a CPU prefetch which 
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ation is completed, and system recovery, with 
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is reported, 
ion-processing damage (either with or without 

with storage-key error uncorrected and a 
storage address, is reported. 



Invalid CBC in the storage key for a channel-program pre- 
fetch which is unused may result in any of the following: 

• The I/O operation is completed, and no machine-check 
condition is reported. 

• The I/O operation is completed, and system recovery, 
with storage-key error uncorrected and a failing- 
storage address, is reported. 

Same as PD for CPU references, but a channel-subsystem 
reference may result in the following combinations of 
I/0-error conditions and machine-check conditions: 

• An I/O-error condition is reported, and no machine- 
check condition is reported. 

• An I/O-error condition is reported; system recovery, 
with or without storage-key error uncorrected and a 
failing-storage address, is reported. 

Instruction-processing damage (either with or without 
backup), with or without a storage-key error uncorrected 
and failing-storage address, is reported. 



Invalid CBC in Storage Keys (Part 2 of 2) 



INVALID CBC IN REGISTERS 



When invalid CBC is detected in a CPU 
register, a machine-check condition may 
be recognized. CPU registers include 
the general, floating-point, and control 
registers, the current PSW, the prefix 
register, the TOD clock, the CPU timer, 
and the clock comparator. 



When a machine- 
occurs, whether or 
invalid CBC in a 
following actions 



check interruption 
not it is due to 
CPU register, the 

affecting the CPU 



registers, other than 
ter and the TOD-clock, 
of the interruption. 



the prefix regis- 
are taken as part 



The contents of the regi sters are 
saved in assigned storage loca- 
tions. Any register which is in 
error is identified by a corre- 
sponding validity bit of zero in 
the machine-check-interruption 



code. Malfunctions detected during 
register saving do not result in 
additional machi ne-check-i nterrup- 
tion conditions; instead, the 
correctness of all the information 
stored is indicated by the appro- 
priate setting of the validity 
bits. 

2. On some models, registers with 
invalid CBC are then validated, 
their actual contents being unpre- 
dictable. On other models, 
programmed validation is required. 

The prefix register and the TOD clock 

are not stored during a machine-check 

interruption, have no corresponding 

validity bit, and are not validated. 

On those models in which registers are 
not automatically validated as part of 
the machine-check interruption, a regis- 
ter with invalid CBC will not cause a 
machi ne-check-i nterrupti on condi ti on 
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unless the contents of the register are 
actually used. In these models, each 
register may consist of one or more 
checking blocks, but multiple registers 
are not included in a single checking 
block. When only a portion of a regis- 
ter is accessed, invalid CBC in the 
unused portion of the same register may 
cause a machine-check-interruption 
condition. For example, invalid CBC in 
the right half of a floating-point 
register may cause a machine-check- 
interruption condition if a LOAD (LE) 
operation attempts to replace the left 
half, or short form, of the register. 

Invalid CBC associated with the prefix 
register cannot safely be reported by 
the machine-check interruption, since 
the interruption itself requires that 
the prefix value be applied to convert 
real addresses to the corresponding 
absolute addresses. Invalid CBC in the 
prefix register causes the CPU to enter 
the check-stop state immediately. 

On those models which do not validate 
registers during a machine-check inter- 
ruption, the following instructions will 
cause validation of a register, provided 
the information in the register is not 
used before the register is validated. 
Other instructions, although they 
replace the entire contents of a regis- 
ter, do not necessarily cause 
val i dati on. 

General registers are validated by 
BRANCH AND LINK (BAL, BALR), BRANCH AND 
SAVE (BAS, BASR), LOAD (LR), and LOAD 
ADDRESS. LOAD (L) and LOAD MULTIPLE 
validate if the operand is on a word 
boundary, and LOAD HALFWORD validates if 
the operand i s on a halfword boundary. 

Floating-point registers are validated 
by LOAD (LDR) and, if the operand is on 
a doubleword boundary, by LOAD (LD). 

Control registers may be validated 
either singly or in groups by using the 
instruction LOAD CONTROL. 

The CPU timer, clock comparator, and 
prefix register are validated by SET CPU 
TIMER, SET CLOCK COMPARATOR, and SET 
PREFIX, respectively. 



occurred. In the case of the CPU timer, 
depending on the model, both the 
machine-check interruption and validat- 
ing instructions may be required to 
restore the CPU timer to full working 
order. 



CHECK-STOP STATE 



In certain situations it is impossible 
or undesirable to continue operation 
when a machine error occurs. In these 
cases, the CPU may enter the check-stop 
state, which is indicated by the check- 
stop indicator. 

In general, the CPU may enter the 
check-stop state whenever an uncorrecta- 
ble error or other malfunction occurs 
and the machine is unable to recognize a 
speci fie machine-check- interrupti on 
condi t i on. 

The CPU always enters the check-stop 
state if any of the following conditions 
exi sts: 

• PSW bit 13 is zero and an exigent 
machine-check condition is gener- 
ated. 

• During the execution of an inter- 
ruption due to one exigent 
machine-check condition, another 
exigent machine-check condition is 
detected. 

• During a machine-check interrup- 
tion, the machine-check-interrup- 
tion code cannot be stored 
successfully, or the new PSW cannot 
be fetched successfully. 



Invalid CBC is 
prefix register. 



detected in the 



A malfunction in the receiving CPU, 
which is detected after accepting 
the order, prevents the successful 
completion of a SIGNAL PROCESSOR 
order and the order was a reset, or 
the receiving CPU cannot determine 
what the order was. The receiving 
CPU enters the check-stop state. 



The TOD clock is validated by SET CLOCK 
if the TOD-clock control is in the 
enable-set position. 



Programmi nq Note 



Depending on the register, and the 
model, the contents of a register may be 
validated by the machine-check intei — 
ruption or the model may require that a 
program execute a validating instruction 
after the machine-check interruption has 



There may be many other conditions for 
particular models when an error may 
cause check stop. 

When the CPU is in the check-stop state, 
instructions and interruptions are not 
executed. The TOD clock is normally not 
affected by the check-stop state. The 
CPU timer may or may not run in the 
check-stop state, depending on the error 
and the model. The start key and stop 
key are not effective in this state. 

The CPU may be removed from the check- 
stop state by CPU reset. 
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configuration* a 
-stop state gener- 

malf uncti on-alert 
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In a multiprocessing 
CPU entering the check 
ates a request for a 
external interruption 
configuration. Except 
of a malfunction aler 
the I/O system are n 
by the check-stop s 
However, depending on 
condition causing the 
CPUs may also be delay 
channel subsystem and 
be affected. 



System Check Stop 



In a multiprocessing configuration, some 
errors, malfunctions, and damage condi- 
tions are of such severity that the 
condition causes all CPUs in the config- 
uration to enter the check-stop state. 
This condition is called a system check 
stop. The state of the channel subsys- 
tem and I/O activity is unpredictable. 



MACHINE-CHECK INTERRUPTION 



A request for a machine-check inter- 
ruption, which is made pending as the 
result of a machine check, is called a 
machi n e- check- i nterruption condition. 
There are two types of machine-check- 
interruption conditions: exigent condi- 
tions and repressible conditions. 



EXIGENT CONDITIONS 



Exigent machine-check-interrupt 
ditions are those in which dama 
would have occurred such that 
of the current instruction o 
ruption sequence cannot safely 
Exigent conditions are of two 
instruction-processing damage a 
damage. In addition to i 
specific exigent conditions, 
damage is used to report any ma 
or error which cannot be i sola 
less severe report. 



Exigent conditions for instruction se- 
quences can be either nullifying exigent 
conditions or terminating exigent condi- 
tions, according to whether the 
instructions affected are nullified or 
terminated. Exigent conditions for 
interruption sequences are terminating 
exigent conditions. The terms "nullifi- 
cation" and "termination" have the same 
meaning as that used in Chapter 6, 
"Interruptions," except that more than 
one instruction may be involved. Thus a 
nullifying exigent condition indicates 
that the CPU has returned to the begin- 



ning of a unit of operation prior to the 
error. A terminating exigent condition 
means that the results of one or more 
instructions may have unpredictable 
values. 



REPRESSIBLE CONDITIONS 
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A machine-check-interruption condition 
not directly related to a machine mal- 
function is called an alert condition. 
The alert conditions are grouped in two 
subclasses: degradation and warning. 
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1. Even though repressible conditions 
are usually reported only at normal 
points of interruption, they may 
also be reported with exigent 
machine-check conditions. Thus, if 
an exigent machine-check condition 
causes an instruction to be abnoi — 
mally terminated and a machine- 
check interruption occurs to report 
the exigent condition, any pending 
repressible conditions may also be 
reported. The meani ngfulness of 
the validity bits depends on what 
exigent condition is reported. 
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2. 



Classification of a damage condi- 
tion as repressible does not imply 
that the damage is necessarily less 
severe than damage classified as an 
exigent condition. The distinction 
is whether action must be taken as 
soon as the damage is detected 
(exigent) or whether the CPU can 
continue processing (repressible). 
For a repressible condition, the 
current instruction can be comple- 
ted before taking the machine-check 
interruption if the CPU is enabled 
for machine checks; if the CPU is 
disabled for machine chrcks, the 
condition can safely be k^pt pend- 
ing until the CPU is again enabled 
for machine checks. 

For example, the CPU may be disa- 
bled for machine-check intei — 
ruptions because it is handling an 
earlier instruction-processing- 
damage interruption. If, during 
that time, an I/O operation encoun- 
ters a storage error, that 
condition can be kept pending 
because it is not expected to 
interfere with the current 
machine-check processing. If, 
however, the CPU also 
reference to the area of 
containing the 
re-enabling machine 
tions, another 
processi ng-damage 
created, which is 
exigent condition 



makes a 
storage 
error before 
check interrup- 
i nstructi on- 
condition is 
treated as an 
and causes the 



3. 



CPU to enter the check-stop state. 

A repressible condition may be a 
floating condition. A floating re- 
pressible condition is eligible to 
cause an interruption on any CPU in 



the configuration. At the point 
when a CPU accepts an interruption 
for a floating repressible condi- 
tion, the condition is no longer 
eligible to cause an interruption 
on the remaining CPUs in the 
conf i gurati on . 



INTERRUPTION ACTION 



A machine-check interruption causes the 
following actions to be taken. The PSW 
reflecting the point of interruption is 
stored as the machine-check old PSW at 
real location 48. The contents of other 
registers are stored in register — save 
areas at real locations 216-231 and 
352-511. After the contents of the 
registers ar& stored in registei — save 
areas, depending on the model, the 
registers may be validated with the 
contents being unpredictable. A 
failing-storage address may be stored at 
real location 248 and an external-damage 
code may be stored at real location 244. 
A machine-check-interruption code (MCIC) 
of eight bytes is placed at real 
location 232. The new PSW is fetched 
from real location 112. Additionally, a 
machine-check logout may have occurred. 
The machine-generated addresses to ac- 
cess the old and new PSW, the MCIC, 
extended interruption information, and 
the fixed-logout area are all real 
addresses. 

The fields accessed during the machine- 
check interruption are summarised in the 
figure "Machine-Check-Interruption Loca- 
ti ons." 





Starti ng 


Length 


Information Stored (Fetched) 


Locati on* 


in Bytes 


Old PSW 


48 


8 


New PSW (fetched) 


112 


8 


Machine-check-interruption code 


232 


8 


Registei — save areas 






CPU timer 


216 


8 


Clock comparator 


224 


8 


Floating-point registers 0, 2, 4, 6 


352 


32 


General registers 0-15 


384 


64 


Control registers 0-15 


448 


64 


Extended interruption information 


x 




External-damage code 


244 


4 


Failing-storage address 


248 


4 


Fixed-logout area 


256 


16 


Explanati on: 






X All locations are in real storage. 



Machi ne-Check-Interrupt i on Locati ons 
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If the machine-check-interruption code 
cannot be stored successfully or the new 
PSW cannot be fetched successf ully, the 
CPU enters the check-stop state. 
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When a repressi ble machine-check i ntei — 
ruption occurs because the interruption 
condition is in a subclass for which the 
CPU is enabled, pending conditions in 
other subclasses may also be indicated 
in the same interruption code, even 
though the CPU is disabled for those 
subclasses. All indicated conditions 
are then cleared. 

If a machine check which is to be 
reported as a system-recovery condition 
is detected during the execution of the 
interruption procedure due to a previous 
machine-check condition, the system- 
recovery condition may be combined with 
the other conditions, discarded, or held 
pendi ng. 

An exigent machine-check condition can 
cause a machine-check interruption only 
when PSW bit 13 is one. When a nullify- 
ing exigent condition causes a machine- 
check interruption, the interruption is 
taken at a normal point of interruption. 
When a terminating exigent condition 
causes a machine-check interruption, the 
interruption terminates the execution of 
the current instruction and may elimi- 
nate the program and supervisoi — call 
interruptions, if any, that would have 
occurred if execution had continued. 
Proper execution of the interruption 
sequence, including the storing of the 
old PSW and other information, depends 
on the nature of the malfunction. When 
an exigent machine-check condition 
occurs during the execution of a machine 
function, such as a CPU-timer update, 



If, during the execution of an intei — 
ruption due to one exigent machine-check 
condition, another exigent machine check 
i s detected, the CPU enters the check- 
stop state. If an exigent machine check 
is detected during an interruption due 
to a repressi ble machine-check 
condition, system damage is reported. 

When PSW bit 13 is zero, an exigent 
machine-check condition causes the CPU 
to enter the check-stop state. 

Machi ne-check- i nterrupti on condi ti ons 
are handled in the same manner regard- 
less of whether the wait-state bit in 
the PSW is one or zero: a machine-check 
condition causes an interruption if the 
CPU is enabled for that condition. 
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POINT OF INTERRUPTION 



The point in the processing which is 
indicated by the interruption and used 
as a reference point by the machine to 
determine and indicate the validity of 
the status stored is referred to as the 
point of interruption. 
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Only certain points in the processing 
may be used as a point of interruption. 
For repressible machine-check inter- 
ruptions, the point of interruption must 
be after one unit of operation is 
completed and any associated program or 
supervisor-call interruption is taken, 
and before the next unit of operation is 
begun. 

Exigent machine-check conditions for 
instruction sequences are those in which 
damage has or would have occurred to the 
instruction stream. Thus, the damage 
can normally be associated with a point 
part way though an instruction, and this 
point is called the point of damage. In 
some cases there may be one or more 
instructions separating the point of 
damage and the point of interruption, 
and the processing associated with one 
or more instructions may be damaged. 
When the point of interruption is a 
point prior to the point of damage due 
to a nullifiable exigent machine-check 
condition, the point of interruption can 
be only at the same points as for 
repressible machine-check conditions. 

In addition to the point of interruption 
permitted for repressible machine-check 
conditions, the point of interruption 
for a terminating exigent machine-check 
condition may also be after the unit of 
operation is completed but before any 
associated program or supervisoi — call 
interruption occurs. In this case, a 
valid PSW instruction address is defined 
as that which would have been stored in 
the old PSW for the program or 
supervisor-call interruption. Since the 
operation has been terminated, the 
values in the result fields, other than 
the instruction address, are unpredict- 
able. Thus the validity bits associated 
with fields which are due to be changed 
by the instruction stream are meaning- 
less when a terminating exigent 
machine-check condition is reported. 



When the point of interruption and the 
point of damage due to an exigent 
machine-check condition are separated by 
a checkpoint-synchronization function, 
the damage has not been i solated to a 
particular program, and system damage is 
i ndi cated. 



Programmi na Note 



When an 
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of damage 
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n of damage, 
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ne-check-i nterrup- 
s, the point of 
chosen affects the 
which must be 
pt is made, when 
point of interrup- 
s the minimum 
In general, the 
nterruption point 
the error. 



When all the status information stored 
as a result of an exigent machine- 
check-interruption condition does not 
reflect the same point, an attempt is 
made when possible to choose the point 
of interruption so that the instruction 
address which is stored in the machine- 
check old PSW is valid. 



MACHINE-CHECK-INTERRUPTION CODE 



On all machine-check interruptions, a 
machine-check-interruption code (MCIC) 
is stored at the doubleword starting at 
real location 232 and has the format 
shown in the figure "Machine-Check 
Interruption-Code Format." 

Bits in the MCIC which are not assigned, 
or not implemented by a particular 
model, are stored as zeros. 
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00000000 


00000000 



32 34 

Bi ts Name 



40 



46 48 



56 



63 



System damage (SD) 

1 Instruction-processing damage (PD) 

2 System recovery (SR) 

4 Timing-facility damage (CD) 

5 External damage (ED) 

6 Vectoi — facility failure (VF) 

7 Degradation (DG) 

8 Warning (W) 

9 Channel report pending (CP) 

10 Service-processor damage (SP) 

11 Channel-subsystem damage (CK) 

13 Vector-facility source (VS) 

14 Backed up (B) 

16 Storage error uncorrected (SE) 

17 Storage error corrected (SO 

18 Storage-key error uncorrected (KE) 

19 Storage degradation (DS) 

20 PSW-MWP validity (WP) 

21 PSW mask and key validity (MS) 

22 PSW program-mask and condition-code validity (PM) 

23 PSW-instructi on-address validity (IA) 

24 Failing-storage-address validity (FA) 

26 External-damage-code validity (EC) 

27 Floating-point-register validity (FP) 

28 General-register validity (GR) 

29 Control-register validity (CR) 

31 Storage logical validity (ST) 

32 Indirect storage error (IE) 
34 Delayed-access exception (DA) 

46 CPU-timer validity (CT) 

47 Clock-comparator validity (CO 

Note ? All other bits of the MCIC are unassigned and stored as zeros 
Machine-Check Interruption-Code Format 



SUBCLASS 



Bits 0-2 and 4-11 are the subclass bits 
which identify the type of machine-check 
condition causing the interruption. At 
least one of the subclass bits is stored 
as a one. When multiple errors have 
occurred, several subclass bits may be 
set to ones. 



isolated to one or more of the less 
severe machine-check subclasses. When 
system damage is indicated, the remain- 
ing bits in the machine-check- 
interruption code ar& not meaningful, 
and information stored in the registei — 
save areas and machine-check extended- 
interruption fields is not meaningful. 

System damage is a terminating exigent 
condition and has no subclass-mask bit. 



Instructi on-Processing Damage 



System Damage 



Bit (SD), when one, indicates that 
damage has occurred which cannot be 



Bit 1 (PD), when one, indicates that 
damage has occurred to the instruction 
processing of the CPU. 

The exact meaning of bit 1 depends on 
the setting of the backed-up bit, bit 
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14. When the backed-up bit is one, the 
condition is called processing backup. 
When the backed-up bit is zero* the 
condition is called processing damage. 
These two conditions are described in 
the section "Synchronous Machine-Check- 
Interruption r |:4,: — -" : ~ 4.u:- 

chapter. 



Conditions" in this 



Instruction-processing damage can be a 
nullifying or a terminating exigent 
I condition and has no subclass-mask bit. 



System Recovery 



Bit 2 

malfun 

result 

fully 

detect 

result 

addi ti 

presen 

recove 



(SR), when 
ctions were 

in damage 
corrected, 
ed as part o 

in a system 
on to an I/O 
ce and ext 
ry capabilit 



one, indicates that 
detected but did not 
or have been success- 
Some malfunctions 
f an I/O operation may 
-recovery condition in 
-error condition. The 
ent of the system- 
y depend on the model . 



System recovery is a repressible condi- 
tion. It is masked by the recovery 
subclass-mask bit, which is in bit posi- 
tion 4 of control register 14. 



enabled for CPU-timer interrup- 
tions. Depending on the model, the 
machine-check condition may be 
generated only as the CPU timer 
enters an error state. Or, the 
machine-check condition may be 
continuously generated whenever the 
CPU is enabled for CPU-timer intei — 
ruptions, until the CPU timer is 
vali dated. 

3. The clock comparator is damaged, 
and the CPU is enabled for clock- 
comparator external interruptions. 
On some models, this condition may 
be recognized even when the CPU is 
not enabled for clock-comparator 
interrupti ons. 

Timing-facility damage may also be set 
along with instruction-processing damage 
when an instruction which accesses the 
TOD clock, CPU timer, or clock compara- 
tor produces incorrect results. Depend- 
ing on the model, the CPU timer or clock 
comparator may be validated by the 
interruption which reports the CPU timer 
or clock comparator as invalid. 

Timing-facility damage is a repressible 
condition. It is masked by the timing- 
facility subclass-mask bit, which is in 
bit position 6 of control register 14. 



Programmi ng Notes 



System recovery may be used to 

report a failing-storage address 

detected by a CPU prefetch or by an 
I/O operation. 

Unless the corresponding validity 
bits are ones, the indication of 
system recovery does not imply 
storage logical validity, or that 
the fields stored as a result of 
the machine-check interruption are 
val i d. 



Timi ng-Faci li tv Damage 



Bit 4 (CD), when one, indicates that 
damage has occurred to the TOD clock, 
the CPU timer, the clock comparator, or 
to the CPU-timer or clock-comparator 
external-interruption conditions. The 
timi ng-faci 1 i ty-damage machi ne-check 
condition is set whenever any of the 
following occurs: 

1. The TOD clock accessed by this CPU 
enters the error or not-operational 
state. 

2. The CPU timer is damaged, and the 
CPU is enabled for CPU-timer 
external interruptions. On some 
models, this condition may be 
recognized even when the CPU is not 



Programmi ng Note 



Timing-facility-damage conditions for 
the CPU timer and the clock comparator 
are not recognized on most models when 
these facilities are not in use. The 
facilities are considered not in use 
when the CPU is disabled for the corre- 
sponding external interruptions (PSW bit 
7, or the subclass-mask bits, bits 20 
and 21 of control register 0, are 
zeros), and when the corresponding set 
and store instructions 
Timi ng-faci 1 i ty~damage 
are already pending 
however, when the CPU 



&re not executed, 
conditions that 
remain pending, 
is di sabled for 



the corresponding external interruption. 

Timing-facility-damage conditions due to 
damage to the TOD clock are always 
recogni zed. 



External Damage 



Bit 5 (ED), when one, indicates that 
damage has occurred during operations 
not directly associated with processing 
the current instruction. 

When bit 5, external damage, is one and 
bit 26, external-damage-code validity, 
is also one, the external-damage code 
has been stored to indicate, in more 
detail, the cause of the external-damage 
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machine-check interruption. When the 
external damage cannot be i solated to 
one or more of the conditions as defined 
in the external-damage code, or when the 
detailed indication for the condition is 
not implemented by the model* external 
damage is indicated with bit 26 set to 
zero. The presence and extent of 
reporting external damage depend on the 
model . 

External damage is a repressible condi- 
tion. It i s masked by the external- 
damage subclass-mask bit, which is in 
bit position 6 of control register 14. 



Vector-Faci 1 i tv Fai lure 



Bit 6 (VF) of the machine-check- 
interruption code, when one, indicates 
that the vector facility has failed to 
such an extent that the service process- 
or has made the facility not available. 

This bit may be set to one regardless of 
whether the vector-control bit, bit 14 
of control register 0, is one or zero. 

Vectoi — facility failure is a repressible 
condition and has no subclass-mask bit. 



interruption occurs. Conversely, the 
request is not cleared by the inter- 
ruption, and, if the condition persists, 
more than one interruption may result 
from the same condition. 

Warning is a repressible condition. It 
is masked by the warning subclass-mask 
bit, which is in bit position 7 of 
control register 14. 



Channel Report Pendi ng 



Bit 9 (CP), when one, 
channel report, cons 
more channel-report wo 
pending, and the 
channel-report words 
further detail, the 
malfunction and the r 
or action performed, 
becomes pending when o 
i ng conditions has occ 



indicates that a 
i sti ng of one or 
rds, has been made 
contents of the 
describe, in 
effect of the 
esults of analysis 

A channel report 
ne of the follow- 
urred: 



Channel-subsystem recovery has been 
completed. The channel-subsystem 
recovery may have been initiated 
with no prior notice to the program 
or may have been a result of a 
condition previously reported to 
the program. 



Degradati on 



Bit 7 (DG), when one 
continuous degradati 
performance, more ser 
indicated by system 
occurred. Degradation 
when system-recovery co 
machi ne-preestabli shed 
unit deletion has occu 
ence and extent of 
report capability depen 



indicates that 
on of system 
ious than that 

recovery, has 
may be reported 
nditions exceed a 
threshold or when 
rred. The pres- 
the degradati on- 
d on the model . 



Degradation is a repressible condition. 
It is masked by the degradation 
subclass-mask bit, which is in bit posi- 
tion 5 of control register 14. 



2. The function specified by RESET 
CHANNEL PATH has been completed. 

The channel-report words which make up 
the channel report may be cleared, one 
at a time, by execution of the instruc- 
tion STORE CHANNEL REPORT WORD, which is 
described in Chapter 14, "I/O 
Instructions." 



Bit 9 is meaningless when 
subsystem damage is reported. 



channel- 



Channel report pending is a floating 
repressible condition. It is masked by 
the channel-report-pending subclass-mask 
bit, which is in bit position 3 of 
control register 14. 



Warni ng 



Bit 8 (W), when one, indicates that 
damage is imminent in some part of the 
system (for example, that power is about 
to fail, or that a loss of cooling is 
occurring). Whether warning conditions 
are recognized depends on the model. 

If the condition responsible for the 
imminent damage is removed before the 
interruption request is honored (for 
example, if power is restored), the 
request does not remain pending, and no 



Servi ce-Processor Damage 



Bit 10 (SP), when one, indicates that 
damage has occurred to the service 
processor. Service-processor damage may 
be made pending at all CPUs in the 
configuration, or it may be detected 
independently by each CPU. The presence 
and extent of reporting service- 
processor damage depend on the model. 

Service-processor damage is a repressi- 
ble condition and has no subclass-mask 
bit. 
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Channel -Subsvsterq Damage 



Bit I Bit 14 Name of Condition 



Bit 11 (CK), when one* indicates that an 
error or malfunction has occurred in the 
channel subsystem, or that the channel 
subsystem is in the check-stop state. 
The channel subsystem enters the check- 
stop state when a malfunction occurs 
which is so severe that the channel 
subsystem cannot continue, or if power 
is lost in the channel subsystem. 

Channel-subsystem damage is a floating 
repressible condition and has no 
subclass-mask bit. 



Vector-FqcUHy Spurcq 



Bit 13 (VS) of the machine-check- 
interruption code, when one, indicates 
that the vector facility is the source 
of the reported machine-check condition. 
Vector-facility source is reported 
together with instruction-processing 
damage. When this bit is one, the 
contents of vector-facility registers 
may have been damaged. 

This bit may be set to one regardless of 
whether the vector-control bit, bit 14 
of control register 0, is one or zero. 



1 Processing damage 
1 1 Processing backup 



Bit 13 is not meaningful when 
facility failure is reported. 



TIME OF INTERRUPTION OCCURRENCE 



vector- 



Processing Backup 



The processing-backup condition indi- 
cates that the point of interruption is 
prior to the point, or points, of error. 
This is a nullifying exigent condition. 
When all of the validity bits associated 
with CPU status &r& indicated as valid, 
the machine has successfully returned to 
a checkpoint prior to the malfunction, 
and no damage has yet occurred. The 
validity bits in the machine-check- 
interruption code which must be one for 
this to be the case are as follows: 

H£K Ml FigMa govern fey. Mi 



20 
21 
22 

23 
27 
28 
29 
31 



46 
47 



PSW MWP bits 
PSW mask and key 
PSW program mask and 

condition code 
PSW instruction address 
Floating-point registers 
General registers 
Control registers 
Storage logical validity 

(result fields within 

current checkpoint 

i nterval) 
CPU timer 
Clock comparator 



Bit 14 (B) of the machine-check- 
interruption code indicates when the 
interruption occurred in relation to the 
error. 



Backed Up 



Bit 14 (B), when one, indicates that the 
point of interruption i s at a checkpoint 
before the point of error. This bit is 
meaningful only when the instruction- 
processing-damage bit, bit 1, is also 
set to one. The presence and extent of 
the capability to indicate a backed-up 
condition depend on the model. 



SYNCHRONOUS MACHINE-CHECK-INTERRUPTION 
CONDITIONS 



The instruction-processing damage and 
backed-up bits, bits 1 and 14 of the 
machine-check-interruption code, identi- 
fy, in combination, two conditions. 



Programmi ng Note 



The processing-backup condition is 
reported rather than system recovery to 
indicate that a malfunction or failure 
stands in the way of continued operation 
of the CPU. The malfunction has not 
been circumvented, and damage would have 
occurred if instruction processing had 
conti nued. 



Processi ng Damage 



The processing-damage condition indi- 
cates that damage has occurred to the 
instruction processing of the CPU. The 
point of interruption is a point beyond 
some or all of the points of damage. 
Processing damage is a terminating 
exigent condition; therefore, the 
contents of result fields may be unpre- 
dictable and still indicated as valid. 

Processing damage may include malfunc- 
tions in program-event recording, moni- 
tor call, tracing, and dynamic address 
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translation. Processing damage causes 
any supervisor-call-interruption condi- 
tion and program-interruption condition 
to be discarded. However, the contents 
of the old PSW and interruption-code 
locations for these interruptions may be 
set to unpredictable values. 



STORAGE-ERROR TYPE 



Bits 16-18 of the machine-check- 
interruption code are used to indicate 
an invalid CBC or a near-valid CBC 
detected in main storage or an invalid 
CBC in a storage key. Bit 19, storage 
degradation, may be indicated concur- 
rently with bit 17. The failing- 
storage-address field, when indicated as 
valid, identifies a location within the 
storage checking block containing the 
error, or, for storage-key error uncor- 
rected, within the block associated with 
the storage key. Bit 32, indirect stor- 
age error, may be set to one to indicate 
that the location designated by the 
failing-storage address is not the 
original source of the error. 

The storage-error-uncorrected and 
storage-key-error-uncorrected bits do 
not in themselves indicate the occur- 
rence of damage because the error 
detected may not have affected a result. 
The portion of the configuration 
affected by an invalid CBC is indicated 
in the subclass field of the machine- 
check-interruption code. 

Storage errors detected for a channel 
program, when indicated as I/O-error 
conditions, may also be reported as 
system recovery. CBC errors that occur 
in storage or in the storage key and 
that are detected on prefetched or 
unused data for a CPU program may or may 
not be reported, depending on the model. 



Storage Error Uncorrected 



Bit 16 (SE), when one, indi 
checking block in main stora 
invalid CBC and that the 
could not be corrected. The 
the checking block in main 
not been changed. The locat 
may have been accessed or pr 
this CPU or another CPU o 
program, or it may have been 
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access. 
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near-valid CBC and that the information 
has been corrected before being used. 
Depending on the model, the contents of 
the checking block in main storage may 
or may not have been restored to valid 
CBC. The location reported may have 
been accessed or prefetched for this CPU 
or for another CPU or for a channel 
program, or it may have been accessed as 
the result of a model-dependent storage 
access. The presence and extent of the 
storage-erroi — correct i on capabi 1 i ty 
depend on the model. This indication 
may or may not be accompanied by an 
indication of storage degradation, bit 
19 CDS). 



Storage-Kev Error Uncorrected 
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Storage Degradation 



Bit 19 CDS), when one, indicates that 
performance degradation has occurred for 
the reported storage-error-corrected 
condi ti on . 

Storage degradation indicates that 
although the associated storage error 
has been corrected, the correction proc- 
ess involved a substantial amount of 
time. Thus, this bit indicates that use 
of the associated block of storage 
should be avoided, if possible. 

The indication of storage degradation 
has meaning only when bit 17, storage 
error corrected, is also one. The pres- 
ence and extent of reporting storage 
degradation depend on the model. 



Programmi ng Note 



Because storage error corrected i s 
normally reported with system recovery, 
the recovery subclass mask, bit 4 of 
control register 14, should be set to 
one in order for storage degradation to 
be indicated. 



Bit 17 (SO, when one, indicates that a 
checking block in main storage contained 
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MACHINE-CHECK INTERRUPTION-CODE VALIDITY 
BITS 



PSU1 Program-Mask and Condition-Code 
Validity 



Bits 20-24, 26-31, 46, and 47 of the 
machine-check-interruption code are 
validity bits. Each bit indicates the 
validity of a particular field in stoi — 
age. With the exception of the 
storage-logical-validity bit (bit 31), 
each bit is associated with a field 
stored during the machine-check intei — 
ruption. When a validity bit is one, it 
indicates that the saved value placed in 
the corresponding storage field is valid 
with respect to the indicated point of 
interruption and that no error was 
detected when the data was stored. 



When a validity bit is zer 
of the following conditi 
occurred: the original i 
incorrect, the original i 
invalid CBC, additional 
were detected while storin 
tion, or none or only 
information was stored. E 
information is unpred 
machine attempts, when 
place valid CBC in the sto 
thus reduce the possibil 
tional machine checks bein 



o, one or more 
ons may have 
nformation was 
nformation had 
malfuncti ons 
g the informa- 

part of the 
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The validity bits for the floating-point 
registers, general registers, control 
registers, CPU timer, and clock compara- 
tor indicate the validity of the saved 
value placed in the corresponding save 
area. The information in these regis- 
ters after the machine-check interrup- 
tion is not necessarily correct even 
when the correct value has been placed 
in the save area and the validity bit 
set to one. The use of the registers 
and the operation of the facility asso- 
ciated with the control registers, CPU 
timer, and clock comparator, are unpre- 
dictable until these registers are 
validated. (See the section "Invalid 
CBC in Registers" earlier in this chap- 
ter.) 



PSW-MWP Validity 



Bit 20 (WP), when 
bits 12-15 of the 
are correct. 



one, indicates that 
machine-check old PSW 



Bit 22 (PM), when one, indicates that 
the program mask and condition code of 
the machine-check old PSW are correct. 



PSW-Instructi on-Address Validi tv 



Bit 23 (IA), when one, indicates that 
the addressing mode and instruction 
address (bits 32-63) of the machine- 
check old PSW are correct. 



Fai 1 i nq-Storaae-Address Vali di tv 
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correct fa 
placed at 
storage-er 
error-unco 
corrected 
presence a 
i denti fy 
depend on 
errors are 
of the ma 
are zeros, 
i s meani ng 
i ndi cated 



), when on 
i li ng-stora 

real loca 
roi — uncorre 
rrected, 
condi ti on 
nd extent o 
the failin 

the mode 
reported, 
chine-check 

the faili 
less, even 
as valid. 



e, indicates that a 
ge address has been 
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-interruption code 
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External -Damage-Code Vali di tv 



Bit 26 (EC), when one, and provided that 
bit 5, external damage, is also one, 
indicates that a valid external-damage 
code has been stored in the word at 
location 244. When bit 5 is zero, bit 
26 has no meaning. 



Float ing-Po in t-Regi ster Vali di tv 



Bit 27 (FP), when one, indicates that 
the contents of the floating-point- 
register save area at real locations 
352-383 reflect the correct state of the 
floating-point registers at the point of 
i nterrupti on. 



PSW Mask and Key Validity 



Bit 21 (MS), when one, indicates that 
the system mask, PSW key, and miscella- 
neous bits of the machine-check old PSW 
are correct. Specifically, this bit 
covers bits 0-11, 16, 17, and 24-31 of 
the PSW. 



General-Regi ster Validity 



Bit 28 (GR), when one, indicates that 
the contents of the general-register 
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save area at real locations 384-447 
reflect the correct state of the general 
registers at the point of interruption. 



Control-Regi ster Val i di tv 



Bit 29 (CR), when one, indicates that 
the contents of the control-register 
save area at real locations 448-511 
reflect the correct state of the control 
registers at the point of interruption. 



Storage Logi cal Val i di tv 



Bit 31 (ST), when one, indicates that 
the storage locations, the contents of 
which are modified by the instructions 
being executed, contain the correct 
information relative to the point of 
interruption. That is, all stores 
before the point of interruption are 
completed, and all stores, if any, after 
the point of interruption are 
suppressed. When a store before the 
point of interruption is suppressed 
because of an invalid CBC, the storage- 
logical-validity bit may be indicated as 
one, provided that the invalid CBC has 
been preserved as invalid. 

When instruction-processing damage is 
indicated but processing backup is not 
indicated, the storage-logical-validity 
bit has no meaning. 

Storage logical validity reflects only 
the instruction-processing activity and 
does not reflect errors in the state of 
storage as the result of I/O operations, 
or of the storing of the old PSW and 
other interruption information. 



Indi rect Storage Error 



Bit 32 (IE), when one, indicates that 
the physical main-storage location iden- 
tified by the failing-storage address is 
not the original source of the error. 
Instead, the error originated in another 
level of the storage hierarchy and has 
been propagated to the current 
physical-storage portion of the storage 
hierarchy. Bit 32 is meaningful only 
when bit 16 or 18 (storage error uncoi — 
rected or storage-key error uncorrected) 
of the machine-check-interruption code 
is one. When bits 16 and 18 are both 
zeros, bit 32 has no meaning. 

For errors originating outside the stoi — 
age hierarchy, the attempt to store is 
rejected, and the appropriate error 
indication is presented. When an error 



is detected during implicit movement of 
information inside the storage 
hierarchy, the action is not rejected 
and reported in this manner because the 
movement may be asynchronous and may be 
initiated as the result of an attempt to 
access completely unrelated information. 
Instead, errors in the contents of the 
source during implicit moving of infoi — 
mation from one portion of the storage 
hierarchy to another may be preserved in 
the target area by placing a special 
invalid CBC in the checking block asso- 
ciated with the target location. These 
propagated errors, when detected later, 
are reported as indirect storage errors. 
The original source of such an error may 
have been in a cache associated with an 
I/O processor or a CPU, or the error may 
have been the result of a data-path 
failure in transmitting data from one 
portion of the storage hierarchy to 
another. Additionally, a propagated 
error may be generated during the move- 
ment of data from one physical portion 
of storage to another as the result of a 
storage-reconfiguration action. 

The presence and extent of reporting 
indirect storage error depend on the 
model . 



Programmi ng Note 



See the programming notes under TEST 
BLOCK in Chapter 10, "Control 
Instructions," for the action which 
should be taken after storage errors are 
reported. 



Delayed Access Except i on 



Bit 34 (DA), when one, indicates that an 
access exception was detected during a 
storage access using DAT when no such 
exception was detected by an earlier 
test for access exceptions. 

Bit 34 is a modifier to instruction- 
processing damage (bit 1) and is mean- 
ingful only when bit 1 of the machine- 
check-interruption code is one. When 
bit 1 is zero, bit 34 has no meaning. 
The presence and extent of reporting 
delayed access exception depend on the 
model . 



Programmi ng Note 



The occurrence of a delayed access 
exception normally indicates that the 
program is using an improper procedure 
to update the DAT tables. 
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CPU-Timer Validity 



REGISTER-SAVE AREAS 



Bit 46 (CT), when one, indicates that 
the CPU timer is not in error and that 
the contents of the CPU-timer save area 
at real location 216 reflect the correct 
state of the CPU timer at the time the 
interruption occurred. 



Clock-Comparator Vali di tv 



Bit 47 (CO, when one, indicates that 
the clock comparator is not in error and 
that the contents of the clock- 
comparator save area at real location 
224 reflect the correct state of the 
clock comparator. 



Programmi ng Note 



The validity bits must be used in 
conjunction with the subclass bits and 
the backed-up bit in order to determine 
the extent of the damage caused by a 
machine-check condition. Mo damage has 
occurred to the system when all of the 
following are true: 

• The four PSW-validity bits, the 
three registei — validity bits, the 
two timing-facility-validity bits, 
and the storage-logical-validity 
bit are all ones. 

• The damage-subclass bits 0, 4, and 
11 are zeros. 

• The instruction-processing-damage 
bit is zero or, if one, the 
backed-up bit is also one. 



MACHINE-CHECK EXTENDED INTERRUPTION 
INFORMATION 
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Each of these fields has associated with 
it a validity bit in the machi ne-check- 
interruption code. If, for any reason, 
the machine cannot store the proper 
information in the field, the associated 
validity bit is set to zero. 
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The following are the five sets of 
registers and the real locations in 
storage where their contents are saved 
during a machine-check interruption. 

Locati ons Regi sters 

216-223 CPU timer 
224-231 Clock comparator 
352-383 Floating-point regis- 
ters 0, 2, 4, 6 
384-447 General registers 0-15 
448-511 Control registers 0-15 



EXTERNAL-DAMAGE CODE 



The word at real location 244 is the 
external-damage code. This field, when 
implemented and indicated as valid, 
describes the cause of external damage. 
The field is valid only when the 
external-damage bit and the external- 
damage-validity bit (bits 5 and 26 in 
the machine-check-interruption code) are 
both ones. The presence and extent of 
reporting an external-damage code depend 
on the model. 

The external-damage code has the follow- 
ing format: 




Expanded Storage Not Operati onal (XN) : 
Bit 8, when one, indicates that the 
controller associated with some or all 
of the expanded storage in the config- 
uration has become not operational. 

Expanded-storage-not-operat i onal condi - 
tions are reported to all CPUs in the 
conf i gurati on. 

Expanded-Storage Control Fai lure (XF) : 
Bit 9, when one, indicates that a 
malfunction has been detected in a 
controller associated with some or all 
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of the expanded storage in the config- 
uration. When expanded-storage control 
failure is indicated* the blocks of the 
expanded storage contain either the 
proper contents or a preserved error. 

Expanded-storage-control-fai lure condi - 
tions are reported to all CPUs in the 
conf i gurati on. 

Reserved : Bits 0-7 and 10-31 are 
reserved for future expansion and are 
always set to zeros. 



FAILING-STORAGE ADDRESS 



conditions associated with system recov- 
ery and warning may also be floating 
interruption conditions. 

A floating interruption is presented to 
the first CPU in the configuration which 
is enabled for the interruption condi- 
tion and can accept the interruption. A 
CPU cannot accept the interruption when 
it is in the check-stop state, has an 
invalid prefix, is performing an unend- 
ing string of interruptions due to a 
PSW-format error of the type that is 
recognized early or is in the stopped 
state. However, a CPU with the rate 
control set to instruction step can 
accept the interruption when the start 
key is activated. 
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In the case of storage errors, the 
failing-storage address may designate 
any byte within the checking block. For 
storage-key error uncorrected, the 
failing-storage address may designate 
any address within the block of storage 
associated with the storage key that is 
in error. When an error is detected in 
more than one location before the intei — 
ruption, the failing-storage address may 
designate any of the failing locations. 
The address stored is an absolute 
address; that is, the value stored is 
the address that is used to reference 
storage after dynamic address trans- 
lation and prefixing have been applied. 



Programmi ng Note 



When a CPU enters the check-stop state 
in a multiprocessing configuration, the 
program on another CPU can determine 
whether a floating interruption may have 
been reported to the failing CPU and 
then lost. This can be accomplished if 
the interruption program places zeros in 
the real storage locations containing 
old PSWs and interruption codes after 
the interruption has been handled (or 
has been moved into another area for 
later processing). After a CPU enters 
the check-stop state, the program in 
another CPU can inspect the old-PSW and 
interruption-code locations of the fail- 
ing CPU. A nonzero value in an old PSW 
or interruption code indicates that the 
CPU has been interrupted but the program 
did not complete the handling of the 
i nterrupti on. 



Floati ng Machi ne-Check-Interrupti on 
Conditions 



HANDLING OF MACHINE-CHECK CONDITIONS 



FLOATING INTERRUPTION CONDITIONS 



An interruption condition which is made 
available to any CPU in a multiprocess- 
ing configuration is called a floating 
interruption condition. The first CPU 
that accepts the interruption clears the 
interruption condition, and it is no 
longer available to any other CPU in the 
conf i gurati on . 

Floating interruption conditions include 
service-signal external-interruption and 
I/O— i nterrupti on conditions. Two 
machi n e- check- i nterrupti on condi tions, 
channel report pending and channel- 
subsystem damage, are floating interrup- 
tion conditions. Depending on the 
model, some machine-check-interruption 
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Floati ng I/O Interrupti ons 



The detection of a machine malfunction 
by the channel subsystem, while in the 
process of presenting an 1/0- 
interruption request for a floating I/O 
interruption, may be reported as channel 
report pending or as channel-subsystem 
damage. Detection of a machine malfunc- 
tion by a CPU, while in the process of 
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accepting a floating I/O interruption* 
is reported as system damage. 



MACHINE-CHECK MASKING 



ation Mill cause 
check-stop state, 
program should 
instructions or 
ruptions with PSW 



the CPU to enter the 
In particular, the 
avoid executing I/O 
allowing I/O intei — 
bit 13 zero. 



All machine-check interruptions are 
under control of the machine-check mask, 
PSW bit 13. In addition, some machine- 
check conditions are controlled by 
subclass masks in control register 14. 

The exigent machine-check conditions 
(system damage and instruction- 
processing damage) are controlled only 
by the machine-check mask, PSW bit 13. 
When PSW bit 13 is one, an exigent 
condition causes a machine-check intei — 
ruption. When PSW bit 13 is zero, the 
occurrence of an exigent machine-check 
condition causes the CPU to enter the 
check-stop state. 

The repressi ble machine-check condi- 
tions, except channel-subsystem damage 
and service-processor damage, are 
controlled both by the machine-check 
mask, PSW bit 13, and by five subclass- 
mask bits in control register 14. If 
PSW bit 13 is one and one of the 
subclass-mask bits is one, the associ- 
ated condition initiates a machine-check 
interruption. If a subclass-mask bit is 
zero, the associated condition does not 
initiate an interruption but is held 
pending. However, when a machine-check 
interruption is initiated because of a 
condition for which the CPU is enabled, 
those conditions for which the CPU is 
not enabled may be presented along with 
the condition which initiates the intei — 
ruption. All conditions presented are 
then cleared. 

Control register 14 contains mask bits 
that specify whether certain conditions 
can cause machine-check interruptions; 
it has the following format: 



Channel-Report-Pendi ng Subclass Mask 



Bit 3 (CM) of control 
trols channel-report- 
ruption conditions, 
initialized to zero. 



Recovery Subclass Mask 



regi ster 
pendi ng 
This 



14 con- 

i ntei — 

bit is 



Bit 4 (RM) of control register 14 con- 
trols system-recovery interruption con- 
ditions. This bit is initialized to 
zero. 



Degradati on Subclass Mask 



Bit 5 (DM) of control register 14 
controls degradation interruption condi- 
tions. This bit is initialized to zero. 



External -Damage Subclass Mask 



Bit 6 (EM) of control register 14 
controls timing-facility-damage and 
external-damage interruption conditions. 
This bit is initialized to one. 




Warning Subclass Mask 



Bit 7 (WM) of control register 14 
controls warning interruption condi- 
tions. This bit is initialized to zero. 



Bits 3-7 of control register 14 are the 
subclass masks for repressible machine- 
check conditions. In addition, bit of 
control register 14 is initialized to 
one, but is otherwise ignored by the 
machine. 



MACHINE-CHECK LOGOUT 



As part of the machine-check inter- 
ruption, some models may place model- 
dependent information in the fixed- 
logout area. This area is 16 bytes in 
length and starts at real location 256. 



Programmi ng Note 



SUMMARY OF MACHINE-CHECK MASKING 



Tho program should avoid, whenever 
possible, operating with PSW b:t 13, the 
machine-check mask, set to zero, since 
any exigent machine-check condition 
which is recognized during this situ- 



A summary of machine-check masking is 
given in the figures "Machine-Check- 
Condition Masking" and "Machine-Check 
Control-Register Bits." 
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Machine-Check Condition 



MCIC 
Bit 



Subclass 



Sub- 
Class 
Mask 



Action When CPU 

Di sabled 

for Subclass 




1 
2 
4 
5 
6 
7 
8 
9 
10 
11 



System damage 

Instruction-processing damage 

System recovery 

Timing-facility damage 

External damage 

Vectoi — facility failure 

Degradat i on 

Warning 

Channel report pending 

Servi ce-processor damage 

Channel-subsystem damage 



RM 
EM 
EM 

DM 
WM 
CM 



Check stop 
Check stop 

Y 

P 

P 

P 

P 

P 

P 

P 

P 



Explanat i on? 



The condition does not have a subclass mask. 

P Indication is held pending. 

Y Indication may be held pending or may be discarded. 

CM Channel-report-pending subclass mask (bit 3 of CR14) 

DM Degradation subclass mask (bit 5 of CR14). 

EM External-damage subclass mask (bit 6 of CR14). 

RM Recovery subclass mask (bit 4 of CR14). 

WM Warning subclass mask (bit 7 of CR14). 



Machine-Check-Condition Masking 



Bit Description 


Control 
Register 14 
Bi t Posi ti on 


State of Bit 
on Initial 
CPU Reset 


Channel-report-pending subclass mask 
Recovery subclass mask 
Degradation subclass mask 
External-damage subclass mask 
Warning subclass mask 


3 

5 
6 

7 





1 




Machine-Check Control-Register Bits 
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CHAPTER 12. OPERATOR FACILITIES 
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Rate Control 12-4 
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Start Key 12-4 
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Multiprocessing Configurations 12-6 



MANUAL OPERATION 



The operator facilities 
tions for the manual 
control of the machine, 
include operatoi — to-ma 
cation, indication of 
control over the setti 
clock, initial program 
and other manual contro 
intervention in n 
operation. 
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A model may provide additional operator 
facilities which are not described in 
this chapter. Examples are the means to 
indicate specific error conditions in 
the equipment, to change equipment con- 
figurations, and to facilitate mainten- 
ance. Furthermore, controls covered in 
this chapter may have additional 
settings which are not described here. 
Such additional facilities and settings 
may be described in the appropriate 
System Library publication. 



The operator facilities may be imple- 
mented on different models in various 
technologies and configurations. On 
some models, more than one set of phys- 
ical representations of some keys, 
controls, and indicators may be 
provided, such as on multiple local or 
remote operating stations, which may be 
effective concurrently. 

A machine malfunction that prevents a 
manual operation from being performed 
correctly, as defined for that 
operation, may cause the CPU to enter 
the check-stop state or give some other 
indication to the operator that the 
operation has failed. Alternatively, a 
machine malfunction may cause a 
machine-check-interruption condition to 
be recognized. 



BASIC OPERATOR FACILITIES 



Most models provide, in association with 
the operator facilities, a console 
device which may be used as an I/O 
device for operator communication with 
the program; this console device may 
also be used to implement some or all of 
the facilities described in this 
chapter. 



ADDRESS-COMPARE CONTROLS 



The address-compare controls provide a 
way to stop the CPU when a preset 
address matches the address used in a 
specified type of main-storage refer- 
ence. 
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One of the address-compare controls is 
used to set up the address to be 
compared with the storage address. 

Another control provides at least two 
positions to specify the action, if any, 
to be taken when the address match 
occurs: 



setting applies to one or all CPUs in 
the configuration and whether an address 
match causes one or all CPUs in the 
configuration to stop. 



ALTER-AND-DISPLAY CONTROLS 



1. The normal position disables the 
address-compare operation. 

2. The stop position causes the CPU to 
enter the stopped state on an 
address match. When the control is 
in this setting, the test indicator 
is on. Depending on the model and 
the type of reference, pending I/O, 
external, and machine-check intei — 
ruptions may or may not be taken 
before entering the stopped state. 

A third control may specify the type of 
storage reference for which the address 
comparison is to be made. A model may 
provide one or more of the following 
positions, as well as others: 



1 



2. 



3. 



The any position causes the address 
comparison to be performed on all 
storage references. 

The data-store position causes 
address comparison to be performed 
when storage i s addressed to store 
data . 



4. 
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Depending on the model and the type of 
reference, address comparison may be 
performed on virtual, real, or absolute 
addresses, and it may be possible to 
specify the type of address. 

In a multiprocessing configuration, it 
depends on the model whether the address 



The operator facilities provide controls 
and procedures to permit the operator to 
alter and display the contents of 
locations in storage, the storage keys, 
the general, f loat i ng- poi nt , and control 
registers, the prefix, and the PSW. 

Before altet — and-di splay operations may 
be performed, the CPU must first be 
placed in the stopped state. During 
alte» — and-di splay operations, the manual 
indicator may be turned off temporarily, 
and the start and restart keys may be 
i noperati ve. 

Addresses used to select storage 
locations for altei — and-di splay oper- 
ations are real addresses. The capabil- 
ity of specifying logical, virtual, or 
absolute addresses may also be provided. 



ARCHITECTURAL-MODE INDICATOR 



The architectural-mode indicator shows 
the architectural mode of operation (the 
System/370 mode or the 370-XA mode) 
selected by the last architectural- 
mode-selection operation. 



ARCHITECTURAL-MODE-SELECTION CONTROLS 



The archi tectural-mode-selecti on con- 
trols provide for the selection of 
either the 370-XA architectural mode of 
operation or the System/370 architec- 
tural mode of operation. Depending on 
the model, the architectural-mode 
selection may be provided as part of the 
IML operation or may be a separate opei — 
at i on . 

As part of the architectural-mode- 
selection process, all CPUs and the 
associated channel-subsystem components 
in a particular configuration are placed 
in the same architectural mode. 



CHECK-STOP INDICATOR 



The check-stop indicator is on when the 
CPU is in the check-stop state. Reset 
operations normally cause the CPU to 
leave the check-stop state and thus turn 
off the indicator. The manual indicator 
may also be on in the check-stop state. 
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IML CONTROLS 



LOAD-NORMAL KEY 



The IML controls provided ««ji th some 
models perform initial microprogram 
loading (IML). The IML operation* when 
provided, may be used to select the 
370-XA mode or the System/370 mode of 
operat i on . 

When the IML operation is completed, the 
state of the affected CPUs, channel 
subsystem, storage, and operator facili- 
ties is the same as if a power-on reset 
had been performed, except that the 
value and state of the TOD clock are not 
changed. 

The IML controls are effective while the 
power is on . 



Act i va 
reset 
i n i t i a 
usi ng 
load~u 
reset 
reset 
the co 
i s pe 
conf i g 
secti o 
Loadi n 



t i ng 

oper 
1 pro 
the 
ni t-a 

i s 
i s pr 
nf i gu 
rform 
urati 
ns "R 
g" in 



the 
ati o 
gram 
I/O 
ddre 
perf 
opag 
rat i 
ed o 
on . 
eset 
Cha 



load 

n t 

loa 

dev i 

55 C 

orme 
a ted 
on , 
n t 
Fo 
s" 
pter 



-normal 
o be 
d i n g to 
ce desi 
ontrols 
don t 

to all 
and a s 
he rem 
r deta 
and "In 

4, "Co 



key 
perf o 

be s 
gnate 
. In 
hi s 

othe 
ubsys 
a i nde 
ils, 
i t i al 
ntrol 



caus 
rmed 
tarte 
d by 
i t i al 
CPU, 
r CPU 
tern r 
r of 

see 
Pro 



es a 

and 

d by 

the 

CPU 

CPU 

s i n 

eset 

the 

the 

gram 



The load-normal key is effective when 
the CPU is in the operating, stopped, 
load, or check-stop state. 



INTERRUPT KEY 



LOAD-UNIT-ADDRESS CONTROLS 



When the interrupt key is activated, an 
* interruption condition indicat- 

'~ 1 ~ ■*" ' is generated. 

Key" 



key 



l n 



external- . . . 

ing the interrupt .._, 

(See the section "Interrupt 

Chapter 6, "Interruptions.") 

The interrupt key is effective when the 
CPU is in the operating or stopped 
state. It depends on the model whether 
the interrupt key is effective when the 
CPU is in the load state. 



LOAD INDICATOR 



The load-unit-address controls specify 

four hexadecimal digits, which provide 

the device number used for initial 

program loading. For details, see the 



Loading" in 



section "Initial Program 
Chapter 4, "Control." 



MANUAL INDICATOR 



The manual indicator is on when the CPU 
is in the stopped state. Some functions 
and several manual controls are effec- 
tive only when the CPU is in the stopped 
state. 



The load indicator is on during initial 
program loading, indicating that the CPU 
is in the load state. The indicator 
goes on when the load-clear or load- 
normal key is activated and the corre- 
sponding operation is started. It goes 
off after the new PSW i s loaded success- 
fully. For details, see the section 
"Initial Program Loading" in Chapter 4, 
"Control." 



LOAD-CLEAR KEY 



Activating the load-clear key causes a 
reset operation to be performed and 
initial program loading to be started by 
using the I/O device designated by the 
load-unit-address controls. Clear reset 
is performed on the configuration. For 
details, see the sections "Resets" and 
"Initial Program Loading" in Chapter 4, 
"Control." 

The load-clear key is effective when the 
CPU is in the operating, stopped, load, 
or check-stop state. 



POWER CONTROLS 



The power controls are used to turn th< 
power on and off. 



The CPU 
operator 
all have 
by comm 
separate 
ular uni 
unit i 
performe 
operat i o 
ly spec 
permi t p 
but the 
tional u 



s, s 

fac 

th 

on c 

pow 

t ha 

s 

d so 
ns a 
i f i e 
ower 
mac 
nt i 1 



to rag 
i 1 i t i 
ei r p 
ontro 
er co 
s its 
reset 

that 
re pe 
d. 

to b 
hi ne 

powe 



e, c 
es, a 
ower 
Is, 
ntrol 
pow 
T 
no i 
rform 
The c 
e tu 
does 
r on 



hannel 
nd I/O d 
turned o 
or they 
5. When 
e r turns 
he seq 
n struct i 
ed unt i 1 
ontrols 
rned on 
not bee 
i 5 compl 



subsy 
evi ce 
n an 
may 
a pa 
d on, 
uence 
ons o 
expl 
may 
i n st 
ome o 
ete. 



stem, 
s may 
d off 

have 
rti c- 

that 
i s 
r I/O 
i ci t- 

also 
ages, 
pera- 



When the power is completely turned on, 
an IML operation is performed on models 
which have &r\ IML function. A powei — on 
reset is then initiated (see the section 
"Resets" in Chapter 4, "Control"). It 
depends on the model whether the archi- 
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tectural mode of operation can be 
selected when the power is turned on, or 
whether the mode-selection controls have 
to be used to change the mode after the 
power is on . 



such as I/O instructions, the SIGNAL 
PROCESSOR instruction, and the INVALI- 
DATE PAGE TABLE ENTRY instruction may 
not operate according to the definitions 
given in this publication. 



RATE CONTROL 



START KEY 



The setting of the rate control deter- 
mines the effect of the start function 
and the manner in which instructions are 
executed. 

The rate control has at least two posi- 
tions. The normal position is the proc- 
ess position. Another position is the 
instruction-step position. When the 
rate control is set to the process posi- 
tion and the start function is 
performed, the CPU starts operating at 
normal speed. When the rate control is 
set to the instruction-step position and 
the wait-state bit is zero, one instruc- 
tion or, for i nterrupt i ble instructions, 
one unit of operation is executed, and 
all pending allowed interruptions are 
taken before the CPU returns to the 
stopped state. When the rate control is 
set to the instruction-step position and 
the wait-state bit is one, no instruc- 
tion is executed, but all pending 
allowed interruptions are taken before 
the CPU returns to the stopped state. 
For details, see the section "Stopped, 
Operating, Load, and Check-Stop States" 
in Chapter 4, "Control." 



Activating the start key causes the CPU 
to perform the start function. (See the 
section "Stopped, Operating, Load, and 
Check-Stop States" in Chapter 4, "Con- 
trol.") 

The start key is effective only when the 
CPU is in the stopped state. The effect 
is unpredictable when the stopped state 
has been entered by a reset. 



STOP KEY 



Activating the stop key causes the CPU 

to perform the stop function. (See the 

section "Stopped, Operating, Load, and 

Check-Stop States" in Chapter 4, "Con- 
trol.") 

The stop key is effective only when the 
CPU is in the operating state. 



The test indicator is 
control is not set to 
t i on . 



on whi le the rate 
the process posi- 



Operati on Note 



Activating the stop key has no effect 
when: 



If the setting of the rate control is 
changed while the CPU is in the operat- 
ing or load state, the results are 
unpredi ctable. 



* An unending string of certain 
program or external interruptions 
occurs. 

• The prefix register contains an 
invalid address. 



RESTART KEY 



Activating the restart key initiates a 

restart interruption. (See the section 

"Restart Interruption" in Chapter 6, 
"Interrupt i ons.") 

The restart key is effective when the 
CPU is in the operating or stopped 
state. The key is not effective when 
the CPU is in the check-stop state. It 
depends on the model whether the restart 
key is effective when any CPU in the 
configuration is in the load state. 

The effect is unpredictable when the 
restart key is activated while any CPU 
in the configuration is in the load 
state. In particular, if the CPU 
performs a restart interruption and 
enters the operating state while another 
CPU is in the load state, operations 



♦ The CPU is in the load or check- 
stop state. 



STORE-STATUS KEY 



Activating the store-status key initi- 
ates a store-status operation. (See the 
section "Store Status" in Chapter 4, 
"Control.") 

The store-status key is effective only 
when the CPU is in the stopped state. 



Operati on Note 



The store-status operation may be used 
in conjunction with a standalone dump 
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program for the analysis of major 
program malfunctions. For such an oper- 
ation, the following sequence would be 
called for: 



The test indicator may be on when one or 
more diagnostic functions under the 
control of DIAGNOSE are activated, or 
when other abnormal conditions occur. 



1. Activation of the stop or system- 
reset-normal key 

2. Activation of the store-status key 

3. Activation of the load-normal key 
to enter a standalone dump program 



Operati on Note 



The system-reset-normal key 
activated in step 1 when (1) 
key is not effective because 
uous string of interruptions 
ring, (2) the prefix register 
an invalid address, or (3) the 
the check-stop state. 



SYSTEM-RESET-CLEAR KEY 



must be 
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a contin- 
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contai ns 
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Acti vati ng 
causes a 
performed, 
uration, a 
all CPUs 
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performed on the 
configuration. For 
section "Resets" 
"Control." 



the system-reset-clear key 

clear-reset operation to be 

In a multiprocessing config- 

clear reset is propagated to 

and storage units in the 

and a subsystem reset i s 

remainder of the 

detai Is, see the 

in Chapter 4, 



The system-reset-clear key is effective 
when the CPU is in the operating, 
stopped, load, or check-stop state. 



SYSTEM-RESET-NORMAL KEY 



Activating the system-reset-normal key 
causes a CPU-reset operation and a 
subsystem-reset operation to be 
performed. In a multiprocessing config- 
uration, a CPU reset is propagated to 
all CPUs in the configuration. For 
details, see the section "Resets" in 
Chapter 4, "Control." 

The system-reset-normal key is effective 
when the CPU is in the operating, 
stopped, load, or check-stop state. 



TEST INDICATOR 



The test indicator is on when a manual 
control for operation or maintenance is 
in an abnormal position that can affect 
the normal operation of a program. 

Setting the address-compare controls to 
the stop position or setting the rate 
control to the instruction-step position 
turns on the test indicator. 
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The abnormal setting of a manual control 
causes the test indicator of the 
affected CPU to be turned on; however, 
in a multiprocessing configuration, the 
operation of other CPUs may be affected 
even though their test indicators are 
not turned on. 



TOD-CLOCK CONTROL 



When the TOD-clock control is not acti- 
vated, that is, the control is set to 
the secure position, the state and value 
of the TOD clock are protected against 
unauthorized or inadvertent change by 
not permitting the instructions SET 
CLOCK or DIAGNOSE to change the state or 
value. 

When the TOD-clock control is activated, 
that is, the control is set to the 
enable-set position, alteration of the 
clock state or value by means of SET 
CLOCK or DIAGNOSE is permitted. This 
setting is momentary, and the control 
automatically returns to the secure 
posi t i on . 

In a multiprocessing configuration, 
activating the TOD-clock control enables 
all TOD clocks in the configuration to 
be set. If there is more than one phys- 
ical representation of the TOD-clock 
control, no TOD clock is secure unless 
all TOD-clock controls in the configura- 
tion are set to the secure position. 



WAIT INDICATOR 



The wait indicator is on when the wait- 
state bit in the current PSW is one. 
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MULTIPROCESSING CONFIGURATIONS 



In a multiprocessing configuration* one 
of each of the following keys and 
controls is provided for each CPU: 
alter and display* interrupt* rate* 
restart* start, stop, and store status. 
The load-clear key, load-normal key, and 
load-unit-address controls are provided 
for each CPU capable of performing I/O 
operations. Alternatively* a single set 
of i ni t ial~proyram-loadi ng keys and 
controls may be used together with a 
control to select the desired CPU. 

There need not be more than one of each 
of the following keys and controls in a 
multiprocessing configuration: address 



compare* IML, power, system reset clear, 
system reset normal, and TOD clock. 

One check-stop, manual, test, and wait 
indicator is provided for each CPU. A 
load indicator is provided only on a CPU 
capable of performing I/O operations. 
Alternatively, a single set of indica- 
tors may be switched to more than one 
CPU. 

There need not be more than one archi- 
tectural-mode indicator in a multiproc- 
essing configuration. 

In a system capable of reconfiguration, 
there must be a separate set of keys, 
controls, and indicators in each config- 
urati on. 
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COMPARISON WITH SYSTEM/370 



Readers familiar with System/370 will 
find that the greatest difference 
between systems operating in the 
System/370 mode and systems operating in 
the 370-XA mode is in the 
(I/O) facilities provided, 
"output" ar& terms used to 
transfer of information 
devices and main storage, 
involving this kind of 
referred to as an input/output (I/O) 
operation. In the 370-XA mode, the I/O 
facilities are collectively called the 
channel subsystem. The channel subsys- 
tem has a different logical structure 
from that of the I/O facilities provided 
in System/370 , with the result that I/O 
instructions, channels, channel sets, 
and 1/0 addressing are replaced in the 
370-XA mode by a new set of I/O 
instructions, by logical device address- 
ing, and by device-accessing mechanisms 
that together provide more function, 
flexibility, and extendi hi 1 i ty. Compat- 
ibility with System/37 has been 
maintained in two areas: (1) CCWs, 
IDAWs, and channel programs, and (2) the 
physical attachment of control units and 
I/O devices to the system. 

In System/370, with some exceptions, 
each channel has a single physical path 
and data-transfer mechanism between the 
channel and its attached control units, 
and the path and channel are often 
thought of as one. In the 370~XA mode, 
because the architecture permits up to 
256 channel paths to be supported by the 
channel subsystem, the term "channel 
path" is specifically used whenever 
referring to the physical path between 
the channel subsystem and one or more 



control units. In most cases, the 
37 0-XA term "channel path" is synonymous 
with the System/370 term "channel" when 
"channel" is used to mean the physical 
path for attachment of control units to 
the system. 

In System/370, a channel has (1) a 
unique channel address within its chan- 
nel set and (2) logically separate and 
distinct facilities for communicating 
with its attached I/O devices and with 
the CPU to which it is connected. For 
example, when an I/O device is attached 
to more than one channel, each channel 
has a separate subchannel that can be 
used to communicate with the I/O device. 
Subchannels are never shared among chan- 
nels, and each subchannel is associated 
with only one channel path. 

In the 370-XA mode, however, a single 
channel subsystem having a single set of 
subchannels is provided. Each subchan- 
nel is uniquely associated with one I/O 
device, and that I/O device is uniquely 
associated with that one subchannel 
within the channel subsystem, regardless 
of the number of channel paths by which 
the I/O device is accessible to the 
channel subsystem. Therefore, the chan- 
nel subsystem has both the attributes of 
a single channel — a unique address 
(since there is only one, addressing is 
implicit) and a single set of subchan- 
nels for all its attached devices — and 
the attributes of multiple channels, 
since it provides for up to 256 channel 
paths and for up to 64K devices. 

Although the logical structures of the 
I/O facilities provided by the two modes 
differ, channel programs that can be 
executed by System/370 channels can be 
executed by the channel subsystem. 
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THE CHANNEL SUBSYSTEM 



The channel subsystem directs the flow 
of information between I/O devices and 
main storage. It relieves CPUs of the 
task of communicating directly with I/O 
devices and permits data processing to 
proceed concurrently with I/O 
processing. The channel subsystem uses 
one or more channel paths as the commu- 
nication link in managing the flow of 
information to or from I/O devices. As 
part of I/O processing* the channel 
subsystem also executes a path- 
management operation, testing for 
channel-path availability, choosing an 
available channel path, and initiating 
execution of the I/O operation with the 
devi ce. 

Within the channel subsystem are 
subchannels. One subchannel is provided 
for and dedicated to each I/O device 
accessible to the channel subsystem. 
Each subchannel provides information 
concerning the associated I/O device and 
its attachment to the channel subsystem. 
The subchannel also provides information 
concerning I/O operations and other 
functions involving the associated I/O 
device. The subchannel is the means by 
which the channel subsystem provides 
information about associated I/O devices 
to CPUs, which obtain this information 
by executing I/O instructions. The 
actual number of subchannels provided 
depends on the model and the configura- 
tion; the maximum addressability is 64K. 

I/O devices are attached through control 
units to the channel subsystem by means 
of channel paths. Control units may be 
attached to the channel subsystem by 
more than one channel path, and an I/O 
device may be attached to more than one 
control unit. In all, an individual I/O 
device may be accessible to the channel 
subsystem by as many as eight different 
channel paths, depending on the model 
and the configuration. The total number 
of channel paths provided by a channel 
subsystem depends on the model and the 
configuration; the maximum address- 
ability is 256. 

The performance of a channel subsystem 
depends on its use and on the system 
model in which it is implemented. Chan- 
nel paths are provided with different 
data-transfer capabilities, and an I/O 



device designed to transfer data only at 
a specific rate (a magnetic-tape unit or 
a disk storage, for example) can operate 
only on a channel path that can accommo- 
date at least this data rate. 

The channel subsystem contains common 
facilities for the control of I/O oper- 
ations. When these facilities are 
provided in the form of separate, auton- 
omous equipment designed specifically to 
control I/O devices, I/O operations are 
completely overlapped with the activity 
in CPUs. The only main-storage cycles 
required by the channel subsystem during 
I/O operations are those needed to 
transfer data and control information to 
or from the final locations in main 
storage, along with those cycles that 
may be required for the channel subsys- 
tem to access the subchannels when they 
are implemented as part of nonaddress- 
able main storage. These cycles do not 
delay CPU programs, except when both the 
CPU and the channel subsystem concui — 
rently attempt to refer to the same 
main-storage area. 



SUBCHANNELS 
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A subchannel 
appearance of 
The subchannel 
required for 
operation. The subchannel consists of 
internal storage that contains informa- 
tion in the form of a CCW address, 
channel-path identifier, device number, 
count, status indications, and 1/0- 
interruption subclass code, as well as 
information on path 
functions pending or 
I/O operations are 
device by executing 
that designate the subchannel associated 
with the device. 



availability and 

being performed. 

initiated with a 

I/O instructions 



Each device has one subchannel per chan- 
nel subsystem by which the device is 
accessible. Each device is assigned to 
a subchannel during an installation 
procedure. The device may be a phys- 
ically identifiable unit, or it may be 
housed internal to a control unit. For 
example, in certain models of the IBM 
3380 Direct-Access Storage, each actua- 
tor used in retrieving the data is 
considered to be a device. In all 
cases, a device, from the point of view 
of the channel subsystem, is an entity 
that is uniquely associated with one 
subchannel and that responds to 
selection by the channel subsystem by 
using the communication protocols 
defined for the type of channel path by 
which it is accessible. 

In some models, subchannels are provided 
in blocks. In these models, more 
subchannels may be provided than there 
are attached devices. Subchannels that 
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are provided but do not have devices 
assigned to them are not used by the 
channel subsystem to perform any func- 
tion and are indicated by storing the 
associated devi ce-numbei — valid bit as 
zero in the subchannel-information block 
of the subchannel . 

The number of subchannels provided by 
the channel subsystem is independent of 
the number of channel paths to the asso- 
ciated devices. For example, a device 
accessible through alternate channel 
paths still is represented by a single 
subchannel. Each subchannel is 
addressed by using a 16-bit binary 
subchannel number. 

After the operation with the subchannel 
has been requested by executing START 
SUBCHANNEL, the CPU is released for 
other work, and the channel subsystem 
assembles or disassembles data and 
synchronizes the transfer of data bytes 
between the I/O device and main storage. 
To accomplish this, the channel subsys- 
tem maintains and updates an address and 
a count that describe the destination or 
source of data in main storage. Simi- 
larly, when an I/O device provides 
signals that should be brought to the 
attention of the program, the channel 
subsystem transforms the signals into 
status information and stores the infoi — 
mat ion in the subchannel, where it can 
be retrieved by the program. 



ATTACHMENT OF I/O DEVICES 



face Channel to 
GA22-6974. 
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CHANNEL PATHS 



The channel subsystem communicates with 
I/O devices by means of channel paths 
between the channel subsystem and 
control units. A control unit may be 
accessible by the channel subsystem by 
more than one channel path. Similarly, 
an I/O device may be accessible by the 
channel subsystem through more than one 
control unit, each having one or more 
channel paths to the channel subsystem. 

Devices that are attached to the channel 
subsystem by multiple channel paths may 
be accessed by the channel subsystem by 
using any of the available channel 
paths. Similarly, a device having the 
dynami c-reconnect i on feature and operat- 
ing in multipath mode can be initialized 
to operate such that the device may 
choose any channel path to which it is 
attached when logically reconnecting to 
the channel subsystem to continue a 
chain of I/O operations. The definition 
of the type of channel path used by the 
channel subsystem and the definition of 
the dynami c-reconnecti on feature are 
given in the System Library publication 
IBM Svstem/360 and System/370 I/O Inter- 



An I/O operation occurs on a channel 
path in one of two modes, depending on 
the facilities provided by the channel 
path and the I/O device. The modes are 
burst and byte-multiplex. 
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Some channel paths can tolerate an 
absence of data transfer for about a 
half minute during a burst-mode opera- 
tion, such as occurs when a long gap on 
magnetic tape is read. An equipment 
malfunction may be indicated when an 
absence of data transfer exceeds the 
prescribed limit. 

In byte-multiplex mode, the I/O device 
stays logically connected to the channel 
path only for a short interval of time. 
The facilities of a channel path capable 
of operating in byte-multiplex mode may 
be shared by a number of concurrently 
operating I/O devices. In this mode all 
I/O operations are split into short 
intervals of time during which only a 
segment of information is transferred 
over the channel path. During such an 
interval, only one device and its asso- 
ciated subchannel are logically 
connected to the channel path. The 
intervals associated with the concurrent 
operation of multiple I/O devices are 
sequenced in response to demands from 
the devices. The channel-subsystem 
facility associated with a subchannel 
exercises its controls for any one opei — 
ation only for the time required to 
transfer a segment of information. The 
segment can consist of a single byte of 
data, a few bytes of data, a status 
report from the device, or a control 
sequence used for the initiation of a 
new operation. 

Ordinarily, devices with high data- 
transfei — rate requirements operate with 
the channel path in burst mode, and 
slower devices run in byte-multiplex 
mode. Some control units have a manual 
switch for setting the desired mode of 
operati on. 

For improved performance, some channel 
paths and control units are provided 
with facilities for high-speed transfer 
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and data streaming. See the System 
Library publication IBM System/360 and 
System/370 I/O I nterface Channel to 
Control Unit OEMI, GA22-6974, for a 
description of those two facilities. 

The modes and features described above 
affect only the protocol used to trans- 
fer information over the char.nel path 
and the speed of transmission. No 
effects are observable by CPU or channel 
programs with respect to the way these 
programs are executed. 



CONTROL UNITS 



From the programmer's point of view, 
most functions performed by the control 
unit can be merged with those performed 
by the I/O device. Therefore, this 
publication normally makes no specific 
mention of the control-unit function; 
the execution of I/O operations is 
described as if the I/O devices communi- 
cated directly with the channel 
subsystem. Reference is made to the 
control unit only when emphasizing a 
function performed by it or when 
describing how the sharing of the 
control unit among a number of devices 
affects the execution of I/O operations. 



A control unit provides the logical 
capabilities necessary to operate and 
control an I/O device and adapts the 
characteristics of each device so that 
it can respond to the standard form of 
control provided by the channel subsys- 
tem. 

Communication between the control unit 
and the channel subsystem takes place 
over a channel path. The control unit 
accepts control signals from the channel 
subsystem, controls the timing of data 
transfer over the channel path, and 
provides indications concerning the 
status of the device. 

The I/O device attached to the control 
unit may be designed to execute only 
certain limited operations, or it may 
execute many different operations. A 
typical operation is moving a recording 
medium and recording data. To accom- 
plish its operations, the device needs 
detailed signal sequences peculiar to 
its type of device. The control unit 
decodes the commands received from the 
channel subsystem, interprets them for 
the particular type of device, and 
provides the signal sequence required 
for execution of the operation. 

A control unit may be housed separately, 
or it may be physically and logically 
integrated with the I/O device, the 
channel subsystem, or a CPU. In the 
case of most electromechanical devices, 
a well-defined interface exists between 
the device and the control unit because 
of the difference in the type of equip- 
ment the control unit and the device 
require. These electromechanical 
devices often ar& of a type where only 
one device of a group attached to a 
control unit is required to transfer 
data at a time (magnetic-tape units or 
disk-access mechanisms, for example), 
and the control unit is shared among a 
number of I/O devices. On the other 
hand, in some electronic I/O devices, 
such as the channel-to-channel adapter, 
the control unit does not have an iden- 
tity of its own. 



I/O DEVICES 



An input/output (I/O) device provides 
external storage, a means of communi- 
cation between data-processing systems, 
or a means of communication between a 
system and its environment. I/O devices 
include such equipment as card readers, 
card punches, magnetic-tape units, 
direct-access-storage devices (for exam- 
ple, disks), display units, typewritei — 
keyboard devices, printers, 
teleprocessing devices, and sensoi — based 
equipment. An I/O device may be phys- 
ically distinct equipment, or it may 
share equipment with other I/O devices. 
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Most types of I/O devices, such as prin- 
ters, card equipment, or tape devices, 
use external media, and these devices 
are physically distinguishable and iden- 
tifiable. Other types are solely elec- 
tronic and do not directly handle 
physical recording media. The channel- 
to-channel adapter, for example, 
provides for data transfer between two 
channel paths, and the data never 
reaches a physical recording medium 
outside main storage. Similarly, the 
IBM 3725 Communication Controller 
handles the transmission of information 
between the data-processing system and a 
remote station, and its input and output 
are signals on a transmission line. 

In the simplest case, an I/O device is 
attached to one control unit and is 
accessible from one channel path. 
Switching equipment is available to make 
some devices accessible from two or more 
channel paths by switching devices among 
control units and by switching control 
units among channel paths. Such switch- 
ing equipment provides multiple paths by 
which an I/O device may be accessed. 
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Multiple channel paths to an I/O device 
are provided to improve performance or 
I/O availability, or both, within the 
system. The management of multiple 
channel paths to devices is under the 
control of the channel subsystem and the 
device, but the channel paths may indi- 
rectly be controlled by the program. 



subchannel of the channel subsystem has 
a subchannel number equal to one less 
than the number of subchannels provided. 
A maximum of 64K subchannels can be 
provided. Normally, subchannel numbers 
are only used in communication between 
the CPU program and the channel subsys- 
tem. 



I/O ADDRESSING 



DEVICE NUMBER 



Four different types of I/O addressing 
are provided by the channel subsystem 
for the necessary addressing of the 
various components: channel-path iden- 
tifiers, subchannel numbers, device 
numbers, and, though not visible to 
programs, addresses dependent on the 
channel-path type. 



CHANNEL-PATH IDENTIFIER 



The channel-path identifier (CHPID) is a 
system-unique eight-bit value assigned 
to each installed channel path of the 
system. A CHPID identifies a physical 
channel path. A CHPID is specified by 
the second-operand address of RESET 
CHANNEL PATH and designates the physical 
channel path that is to be reset. The 
channel paths by which a device is 
accessible are identified 
subchannel-information block 
each by its associated CHPID, 
SUBCHANNEL is executed. The 
also be used in operator messages when 
it is necessary to identify a particular 
channel path. A system model may 
provide as many as 256 channel paths. 
The maximum number of channel paths and 
the assignment of CHPIDs to channel 
paths depends on the system model . 



i n the 

(SCHIB), 

when STORE 

CHPID can 



SUBCHANNEL NUMBER 



A subchannel 
16-bit binary 



number is a system-unique 
number used to address a 



subchannel. The subchannel is addressed 
by seven I/O instructions: CLEAR 
SUBCHANNEL, HALT SUBCHANNEL, MODIFY 
SUBCHANNEL, RESUME SUBCHANNEL, START 
SUBCHANNEL, STORE SUBCHANNEL, and TEST 
SUBCHANNEL. Each I/O device accessible 
to the channel subsystem is assigned a 
dedicated subchannel at installation 
time. All I/O functions relative to a 
specific I/O device are specified by the 
program by designating the subchannel 
assigned to the I/O device. Subchannels 
are always assigned subchannel numbers 
within a single range of contiguous 
numbers. The lowest-numbered subchannel 
is subchannel 0. The highest-numbered 



Each subchannel that has an I/O device 
assigned to it also contains a system- 
unique parameter called the device 
number. The device number is a 16-bit 
binary number that is assigned as one of 
the parameters of the subchannel at the 
time the device is assigned to the 
subchannel . 



The device number p 
identify a device, 
limitations imposed 
the configuration, 
protocols. The devi 
communications cone 
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the system operator 
device number is en 
operator to designa 
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DEVICE IDENTIFIER 



rovides a means to 

independent of any 

by the system model, 

or channel-path 
ce number is used in 
erning the device 
ween the system and 

For example, the 
tered by the system 
te the input device 
al program loading. 



A device identifier is 
apparent to the program, 
the channel subsystem 
with I/O devices. The 
identifier used depends 
channel-path type and 
provided. Each subchannel 
or more device identifiers. 



an address not 
that is used by 
to communicate 
type of device 
on the specific 
the protocols 
contains one 



The channel-path type used by the chan- 
nel subsystem is described in the System 
Library publication IBM System/360 and 
System/570 I/O Interface Channel to 
Control Unit OEMI, GA22-6974. For this 
type of channel path, the device identi- 
fier is called a device address and 
consists of an eight-bit binary number. 

The device address identifies the 
particular I/O device and control unit 
associated with a subchannel. The 
device address may identify, for 
example, a particular magnetic-tape 
drive, disk-access mechanism, or trans- 
mission line. Any number in the range 
0-255 can be assigned as a device 
address. 

For further information about the 1/0- 
device address used with the IBM I/O 
interface, see the publication referred 
to above. 
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Programme ng Note 



The device number is assigned at 
device-installation time and may have 
any value so long as it is system- 
unique. Device numbers may be assigned 
installation-unique values in multicom- 
puter installations in order 
ambiguity, particularly where 
can be switched between two 
systems. 



to avoid 

a device 

or more 



In installations in which a system may 
be operated sometimes in the System/370 
mode and sometimes in the 370-XA mode, 
it is advisable to make the 370-XA 
device number and System/370 I/O address 
equivalent to prevent operational prob- 
lems in such mixed environments. 

Additionally, the user must observe any 
restrictions on device-number assignment 
that may be required by the control 
program, support programs, or the 
particular control unit or I/O device. 



I EXECUTION OF I/O OPERATIONS 



I/O operations are initiated, and 
controlled by information with three 
types of formats: the instruction START 
SUBCHANNEL, channel-command words 
(CCWs), and orders. The START SUBCHAN- 
NEL instruction is executed by a CPU and 
is part of the CPU program that supei — 
vises the flow of requests for I/O 
operations from other programs that 
manage or process the I/O data. When 
START SUBCHANNEL is executed, parameters 
are passed to the target subchannel 
requesting that the channel subsystem 
perform a start function with the I/O 
device associated with the subchannel. 
The channel subsystem performs the start 
function by using information at the 
subchannel, including the information 
passed during the execution of the START 
SUBCHANNEL instruction, to find an 
accessible channel path to the device. 
Once the device has been selected, 
execution of an I/O operation is accom- 
plished by the decoding and executing of 
a CCW by the channel subsystem and the 
I/O device. One or more CCWs arranged 
for sequential execution form a channel 
program and are executed as one or more 
I/O operations, respectively. Both 
instructions and CCWs are fetched from 
main storage, and their formats are 
common for all types of I/O devices, 
although the modifier bits in the 
command code of a CCW may specify 
device-dependent conditions for the 
execution of an operation at the device. 

Operations peculiar to a device, such as 
rewinding tape or positioning the access 
mechanism on a disk drive, are specified 
by orders which are decoded and executed 
by I/O devices. Orders may be trans- 



ferred to the device as modifier bits in 
the command code of a control command, 
may be transferred to the device as data 
during a control or write operation, or 
may be made available to the device by 
other means. 



START-FUNCTION INITIATION 



CPU programs 
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of the f i rst 
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o be executed and the stoi — 
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When the ORB contents have been passed 
to the subchannel, the execution of 
START SUBCHANNEL is complete. The 
results of the execution of the instruc- 
tion are indicated by the condition code 
set in the program-status word. 

When facilities become available, the 
channel subsystem fetches the first CCW 
and decodes it according to the format 
bit specified in the ORB. If the format 
bit is zero, format-0 (System/370- 
compatible) CCWs are specified. If the 
format bit is one, format-1 CCWs are 
specified. Format-0 and format-1 CCWs 
contain the same information, but the 
fields are arranged differently in the 
format-1 CCW so that 31-bit addresses 
can be specified directly in the CCW. 



PATH MANAGEMENT 



If the first CCW passes certain validity 
tests and does not have the suspend flag 
specified, the channel subsystem 
attempts device selection by choosing a 
channel path from the group of channel 
paths that are available for selection. 
A control unit that recognizes the 
device identifier connects itself 
logically to the channel path and 
responds to its selection. The channel 
subsystem subsequently sends the 
command-code part of the CCW over the 
channel path, and the device responds 
with a status byte indicating whether 
the command can be executed. The 
control unit may logically disconnect 
from the channel path at this time, or 
it may remain connected to initiate data 
transfer. 

If the attempted selection does not 
occur as a result of either a busy indi- 
cation or a path-not-operational condi- 
tion, the channel subsystem attempts to 
select the device by an alternate chan- 
nel path if one is available. When 
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CHANNEL-PROGRAM EXECUTION 



If the command is initiated at the 
device and command execution does not 
require any data to be transferred to or 
from the device, the device may signal 
the end of the operation immediately on 
receipt of the command code. In opei — 
ations that involve the transfer of 
data, the subchannel is set up so that 
the channel subsystem will respond to 
service requests from the device and 
assume further control of the operation. 

An I/O operation may involve the trans- 
fer of data to or from one storage area, 
designated by a single CCW, or to or 
from a number of noncontiguous storage 
areas. In the latter case, generally a 
list of CCWs is used for execution of 
the I/O operation, each CCW designating 
a contiguous storage area, and the CCWs 
are coupled by data chaining. Data 
chaining is specified by a flag in the 
CCW and causes the channel subsystem to 
fetch another CCW upon the exhaustion or 
filling of the storage area designated 
by the current CCW. The storage area 
designated by a CCW fetched on data 
chaining pertains to the I/O operation 
already in progress at the I/O device, 
and the I/O device is not notified when 
a new CCW is fetched. 

Provision is made in the CCW format for 
the programmer to specify that, when the 
CCW is decoded, the channel subsystem 
request an I/O interruption as soon as 
possible, thereby notifying a CPU 
program that chaining has progressed at 
least as far as that CCW in the channel 
program. 
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addressing permits essentially the same 
CCW sequences to be used for a program 
running with dynamic address translation 
active in a CPU as would be used if the 
CPU were operating with equivalent 
contiguous real storage. CCW indirect 
data addressing permits the program to 
designate data blocks having absolute 
storage addresses up to 2 31 -1, independ- 
ent of whether format-0 or format-1 CCWs 
have been specified in the ORB. 

In general, execution of an I/O opei — 
ation or chain of operations involves as 
many as three levels of participation: 

1. Except for effects due to the inte- 
gration of CPU and channel- 
subsystem equipment, a CPU is busy 
for the duration of the execution 
of START SUBCHANNEL, which lasts 
until the addressed subchannel has 
been passed the ORB contents. 

2. The subchannel is busy for a new 
START SUBCHANNEL from the receipt 
of the ORB contents until the 
primary interruption condition is 
cleared at the subchannel. 

3. The I/O device is busy from the 
initiation of the first operation 
at the device until either the 
subchannel becomes suspended or the 
secondary interruption condition is 
placed at the subchannel. In the 
case of a suspended subchannel, the 
device again becomes busy when 
execution of the suspended channel 
program is resumed. 



CONCLUSION OF I/O OPERATIONS 



The conclusion of an I/O operation 
normally is indicated by two status 
conditions: channel end and device end. 
The channel-end condition indicates that 
the I/O device has received or provided 
all data associated with the operation 
and no longer needs channel-subsystem 
facilities. This condition is called 
the primary interruption condition, and 
the channel end in this case is the 
primary status. Generally, the primary 
interruption condition is any intei — 
ruption condition that relates to an I/O 
operation and that signals the conclu- 
sion at the subchannel of the I/O 
operation or chain of I/O operations. 

The device-end signal indicates that the 
I/O device has concluded execution and 
is ready to execute another operation. 
This condition is called the secondary 
interruption condition, and the device 
end in this case is the secondary 
status. Generally, the secondary intei — 
ruption condition is any interruption 
condition that relates to an I/O opera- 
tion and that signals the conclusion at 
the device of the I/O operation or chain 
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of operations. The secondary inter- 
ruption condition can occur concurrently 
with, or later than, the primary inter- 
ruption condition. 

Concurrent with the primary or secondary 
interruption conditions, both the chan- 
nel subsystem and the I/O device can 
provide indications of unusual situ- 
ations. 

The conditions signaling the conclusion 
of an I/O operation can be brought to 
the attention of the program by I/O 
interruptions or, when the CPUs are 
disabled for I/O interruptions, by 
programmed interrogation of the channel 
subsystem. In the former case, these 
conditions cause storing of the 1/0- 
interruption code, which contains 
information concerning the interrupting 
source. In the latter case, the intei — 
ruption code is stored as a result of 
the execution of TEST PENDING INTER- 
RUPTION. 

When the primary interruption condition 
is recognized, the channel subsystem 
attempts to notify the program, by means 
of an interruption request, that a 
subchannel contains information describ- 
ing the conclusion of an I/O operation 
at the subchannel. The information 
identifies the last CCW used and may 
provide its residual byte count, thus 
describing the extent of main storage 
used. Both the channel subsystem and 
the I/O device may provide additional 
indications of unusual conditions as 
part of either the primary or secondary 
interruption condition. The information 
contained at the subchannel may be 
stored by the execution of TEST SUBCHAN- 
NEL or the execution of MODIFY 
SUBCHANNEL. This information, when 
stored, is called a subchannel-status 
word (SCSW). 

Facilities are provided for the program 
to initiate execution of a chain of I/O 
operations with a single START SUBCHAN- 
NEL instruction. When the current CCW 
specifies command chaining and no unusu- 
al conditions have been detected during 
the operation, the receipt of the 
device-end signal causes the channel 
subsystem to fetch a new CCW. If the 
CCW passes certain validity tests and 
the suspend flag is not specified in the 
new CCW, execution of a new command is 
initiated at the device. If the CCW 
fails to pass the validity tests, the 
new command is not initiated, command 
chaining is suppressed, and the status 
associated with the new CCW causes an 
interruption condition to be generated. 
If the suspend flag is specified, 
execution of the new command is not 
initiated, and command chaining is 
concluded. 

Execution of the new command is initi- 
ated by the channel subsystem in the 
same way as the previous operation. The 



ending signals occurring at the conclu- 
sion of an operation caused by a CCW 
specifying command chaining are not made 
available to the program. When another 
I/O operation is initiated by command 
chaining, the channel subsystem contin- 
ues execution of the channel program. 
If, however, an unusual condition has 
been detected, command chaining is 
suppressed, the channel program is 
terminated, an interruption condition is 
generated, and the ending signals caus- 
ing the termination are made available 
to the program. 

The suspend-and-resume function provides 
the program with control over the 
execution of a channel program. The 
initiation of the suspend function is 
controlled by the setting of the 
suspend-control bit in the ORB. The 
suspend function is signaled to the 
channel subsystem during channel-program 
execution by specifying the suspend (S) 
flag in the first CCW or in a CCW 
fetched during command chaining. 

Suspension occurs when the channel 
subsystem fetches a CCW with a valid S 
flag. The command in this CCW is not 
sent to the I/O device, and the device 
is signaled that the chain of commands 
is concluded. A subsequent RESUME 
SUBCHANNEL instruction informs the chan- 
nel subsystem that the CCW that caused 
suspension may have been modified and 
that the channel subsystem must refetch 
the CCW and examine the current setting 
of the suspend flag. If the suspend 
flag is found to be not specified in the 
CCW, the channel subsystem resumes 
execution of the chain of commands with 
the I/O device. 

Channel-program execution may be termin- 
ated prematurely by HALT SUBCHANNEL or 
CLEAR SUBCHANNEL. The execution of HALT 
SUBCHANNEL causes the channel subsystem 
to issue the halt signal to the I/O 
device and terminate channel-program 
execution at the subchannel. When 
channel-program execution is terminated 
by the execution of HALT SUBCHANNEL, the 
program is notified of the termination 
by means of an I/O-i nterrupti on request. 
The interruption request is generated 
when the device presents status for the 
terminated operation. If, however, the 
halt signal was issued to the device 
during command chaining after the 
receipt of device end but before the 
next command was transferred to the 
device, the interruption request is 
generated after the device has been 
signaled. In the latter case, the 
device-status field of the SCSW will 
contain zeros. The execution of CLEAR 
SUBCHANNEL clears the subchannel of 
indications of the channel program in 
execution, causes the channel subsystem 
to issue the clear signal to the I/O 
device, and causes the channel subsystem 
to generate an I/O interruption request 
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to notify the program of the completion 
of the clear function. 



I/O INTERRUPTIONS 



Conditions causing I/O-i nterrupti on 
requests are asynchronous to activity in 
CPUs, and more than one condition can 
occur at the same time. The conditions 
are preserved at the subchannels until 
cleared by TEST SUBCHANNEL or CLEAR 
SUBCHANNEL, or reset by an I/O-system 
reset . 

When an I/O-i nterrupti on condition has 
been recognized by the channel subsystem 
and indicated at the subchannel, an 
I/O-i nterrupti on request is made pending 
for the I/O-i nterrupti on subclass speci- 
fied at the subchannel. The 1/0- 
i nterrupti on subclass for which the 
interruption is made pending is under 
programmed control through the use of 
MODIFY SUBCHANNEL. A pending I/O inter- 
ruption may be accepted by any CPU that 
is enabled for interruptions from its 
I/O-i nterrupti on subclass. Each CPU has 
eight mask bits in control register 6 
which control the enabling of that CPU 
for each of the eight l/0~i nterrupti on 
subclasses, with the I/O mask (bit 6) in 
the PSW the master I/O-i nterrupti on mask 
for the CPU. 



When an I/O interruption occurs at a 
CPU, the I/O-i nterrupti on code is stored 
in the I/O-communi cati on area of that 
CPU, and the I/O-i nterrupti on request is 
cleared. The I/O-i nterrupti on code 
identifies the subchannel for which the 
interruption was pending. The condi- 
tions causing the generation of the 
interruption request may then be 
retrieved from the subchannel explicitly 
by TEST SUBCHANNEL or by STORE SUBCHAN- 
NEL. 
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Normally, unless the interruption 
request is cleared by CLEAR SUBCHANNEL, 
the program executes TEST SUBCHANNEL to 
obtain information concerning the 
execution of the operation. 
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INTRODUCTION 



The I/O instructions include all 
instructions that are provided for the 
control of channel-subsystem operations. 
The 13 I/O instructions are listed in 
the figure "Summary of I/O Instruc- 
tions." All of the I/O instructions &re 
privileged instructions. 

Several I/O instructions result in the 
channel subsystem being signaled to 
perform functions asynchronous to the 
execution of the instructions. The 
description of each instruction of this 
type contains a section called "Associ- 
ated Functions," which summarizes the 
asynchronous functions. 



All I/O instructions that reference a 
subchannel use the contents of general 
register 1 as an implied operand. For 
these I/O instructions, general register 
1 contains the subsystem-identification 
word. The subsystem-identification word 
has the following format: 



0000000000000001 


Subchannel 
Number 







16 



31 



Bits 16-31 form the binary number of the 
subchannel to be used for the function 
specified by the instruction. 



I/0-INSTRUCTION FORMATS 



All I/O instructions use the S format: 



I/0-INSTRUCTION EXECUTION 



SERIALIZATION 
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The execution of any I/O instruction 
causes serialization and checkpoint 
synchronization to occur. For a defi- 
nition of the serialization of CPU opei — 
ations, see the section "CPU 
Serialization" in Chapter 5, "Program 
Executi on ." 



OPERAND ACCESS 



During execution of an I/O instruction, 
the order in which fields of the operand 



Chapter 14. I/O Instructions 14-1 



and fields of the subchannel (if appli- 
cable) are accessed is unpredictable. 
It is also unpredictable as to whether 
fetch accesses are made to fields of an 
operand or the subchannel (as 
applicable) when those fields are not 
needed to complete execution of the I/O 
instruction. (See the section "Relation 
Between Operand Accesses" in Chapter 5, 
"Program Execution.") 



In situations where conditions exist 

that could cause more than one nonzero 

condition code to be set* priority of 

the condition codes is as follows: 



Condition code 
condition codes 

Condition code 
condition code 2 



3 has precedence 
1 and 2. 



over 



1 has precedence over 



CONDITION CODE 



PROGRAM EXCEPTIONS 



During the execution of some I/O 
i nstructi ons> the results of certain 
tests are used to set one of four condi- 
tion codes in the PSW. The I/O 
instructions for which execution can 
result in the setting of the condition 
code are listed in the figure "Summary 
of I/O Instructions." The condition 
code indicates the result of the 
execution of the I/O instrucvion. The 
general meaning of the condition code 
for I/O instructions is given below; the 
meaning of the condition code for a 
specific instruction appears in the 
description of that instruction. 

Condi t ion Code 0.: Instruction execution 
produced the expected or most probable 
result. (See the section "Deferred 
Condition Code" in Chapter 16, "I/O 
Interruptions," for a description of 
conditions that can be encountered 
subsequent to the presentation of condi- 
tion code that result in a nonzero 
deferred condition code.) 

Condi ti on Code 1.: Instruction execution 
produced the alternate or second-most- 
probable result, or status conditions 
were present that may or may not have 
prevented the expected result. 

Condi ti on Code Z- Instruction execution 
was ineffective because the designated 
subchannel or channel-subsystem facility 
was busy with a previously initiated 
functi on. 

Condi tion Code 3: Instruction execution 
was ineffective because the designated 
element was not operational or because 
some condition precluded initiation of 
the normal function. 



The program exceptions that the I/O 
instructions can encounter are access, 
operand, privileged-operation, and spec- 
ification exceptions. The figure "Sum- 
mary of I/O Instructions" shows the 
exceptions that are applicable to each 
of the I/O instructions. The execution 
of the instruction is suppressed for 
privileged-operation, operand, and spec- 
ification exceptions. Except as 
indicated otherwise in the section "Spe- 
cial Conditions" for each instruction, 
the instruction ending for access 
exceptions is as described in the 
section "Recognition of Access 
Exceptions" in Chapter 6, "Interrup- 
t i ons." 



INSTRUCTIONS 



The mnemonics, format, and operation 
codes of the I/O instructions are given 
in the figure "Summary of I/O 
Instructions." The figure also indi- 
cates the conditions that can cause a 
program interruption and whether the 
condition code is set. 

In the detailed descriptions of the 
individual instructions, the mnemonic 
and the symbolic operand designation for 
the assembler language are shown with 
each instruction. In the case of START 
SUBCHANNEL, for example, SSCH is the 
mnemonic and D 2 (B 2 ) the operand desig- 
nat i on. 
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Name 


Mne- 
moni c 


Character i sties 


Op 
Code 


CLEAR SUBCHANNEL 
HALT SUBCHANNEL 
MODIFY SUBCHANNEL 
RESET CHANNEL PATH 
RESUME SUBCHANNEL 


CSCH 
HSCH 
MSCH 
RCHP 
RSCH 


S C 
S C 
S C 
S C 
S C 


P 

P 

P A SP 

P 

P 


OP $ GS 
OP * GS 
OP * GS 
OP * Gl 
OP * GS 




B230 
B231 
B232 
B23B 
B238 


SET ADDRESS LIMIT 

SET CHANNEL MONITOR 

START SUBCHANNEL 

STORE CHANNEL PATH STATUS 

STORE CHANNEL REPORT WORD 


SAL 

SCHM 

SSCH 

STCPS 

STCRW 


S 

S 

S C 

S 

S C 


P 

P 

P A SP 

P A SP 

P A SP 


OP * Gl 
OP * GM 
OP * GS 


ST 
ST 


B237 
B23C 
B233 
B23A 
B239 


STORE SUBCHANNEL 

TEST PENDING INTERRUPTION 

TEST SUBCHANNEL 


STSCH 

TPI 

TSCH 


S C 
S C 
S C 


P A SP 
P A 1 SP 
P A SP 


OP « GS 
OP * GS 


ST 
ST 
ST 


B234 
B236 
B235 


Explanati on: 




$ Causes serialization and checkpoint synchronization. 

A Access exceptions for logical addresses. 

A x When the effective address is zero, it is not used to access storage* 

and no access exceptions can occur. 
C Condition code is set. 
Gl Instruction execution includes the implied use of general register 1 

as a parameter. 
GM Instruction execution includes the implied use of multiple general 

registers. General register 1 is used as a parameter, and general 

register 2 may be used as a parameter depending on the contents of 

general register 1. 
GS Instruction execution includes the implied use of general register 1 

as the subsystem-identification word. 
OP Operand exception. 
P Privileged-operation exception. 
S S instruction format. 
SP Specification exception. 
J ST PER storage-alteration event. 



Summary of I/O Instructions 



CLEAR SUBCHANNEL 



CSCH 
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The designated subchannel is cleared* 
the current start or halt function, if 
any, is terminated at the designated 
subchannel, and the channel subsystem is 
signaled to asynchronously perform the 
clear function at the designated 
subchannel and at the associated device. 

General register 1 contains the 

subsystem-identification word, which 

designates the subchannel that is to be 
cleared. 

If a start or halt function is in 
progress, it is terminated at the sub- 
channel . 
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The subchannel is made 
status-pending. All activi 
cated in the acti vi ty-cont 
the SCSW, is cleared at th 
except that the subchan 
cleai — pending. Any fu 
progress, as indicated in 
control field of the SCSW, 
at the subchannel, except 
function which is to 
because of the executi 
i nstructi on . 



The channel subsystem is signaled to 
asynchronously perform the clear func- 
tion. The clear function is summarized 
below in the section "Associated Func- 
tions™ and is described in detail in the 
section "Clear Function" in Chapter 15, 
"Basic I/O Functions." 

Condition code is set to indicate that 
the actions described above have been 
taken. 
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Associated Functi ons 



Program Excepti ons ? 



Subsequent to the execution of CLEAR 
SUBCHANNEL , the channel subsystem 
asynchronously performs the clear func- 
tion. If conditions allow> the channel 
I subsystem chooses a channel path and 
attempts to issue the clear signal to 
the device to terminate the I/O opera- 
tion, if any. The subchannel then 
becomes status-pending. Conditions 
encountered by the channel subsystem 
that preclude issuing the clear signal 
to the device do not prevent the 
subchannel from becoming status-pending 
(see the section "Clear Function" in 
Chapter 15, "Basic I/O Functions"). 

When the subchannel becomes status- 
| pending as a result of performing the 
clear function, data transfer, if any, 
with the associated device has been 
terminated. The SCSW stored when the 
resulting status is cleared by TEST 
SUBCHANNEL has the clear-function bit 
I stored as one. If the channel subsystem 
I can determine that the clear signal was 
issued to the device, the cleat — pending 
bit is stored as zero in the SCSW. 
Otherwise, the cleai — pending bit is 
stored as one, and other indications are 
provided that describe in greater detail 
the condition that was encountered. 
(See the section "Interruption-Response 
Block" in Chapter 16, "I/O 
Interruptions.") 

I Measurement data is not accumulated and 
the device-connect time is not stored in 
the extended-status word for the 
subchannel for a start function that is 
terminated by CLEAR SUBCHANNEL. 



Special Condi ti ons 



Condition code 3 is set and no other 
action is taken when the subchannel is 
not operational for CLEAR SUBCHANNEL. A 
subchannel is not operational for CLEAR 
SUBCHANNEL when the subchannel is not 
provided in the channel subsystem, has 
no valid device number assigned to it, 
or is not enabled. 

CLEAR SUBCHANNEL can encounter the 
program exceptions that are listed 
below. Bit positions 0-15 of general 
register 1 must contain the value 0001 
hex; otherwise, an operand exception is 
recogni zed. 

Resulti ng Condi ti on Code: 

Function initiated 



Operand 

Privileged operation 



Not operational 



HALT SUBCHANNEL 



HSCH 
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The current start function, if any, is 
terminated at the designated subchannel, 
and the channel subsystem is signaled to 
asynchronously perform the halt function 
at the designated subchannel and at the 
associated device. 



General register 1 
subsystem-i denti f i cat i on 
designates the subchannel 
halted. 



contains the 

word, which 

that is to be 



If a start function is in progress, 
is terminated at the subchannel. 



it 



The subchannel is made halt-pending and 
the halt function is indicated at the 
subchannel . 



When HALT SUBCHANNEL is ex 
designated subchannel i 
and-devi ce-acti ve and 
with intermediate status, 
pending indication is el 
the discussion of bits 24, 
the section "Activity Con 
ter 16, "I/O Interrupt 
status-pending condition 
lished as part of the halt 
the section "Associate 
below) . 



ecuted and the 
s subchannel- 
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the status- 
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The channel subsystem is signaled to 
asynchronously perform the halt 
function. The halt function is summa- 
rized below in the section "Associated 
Functions" and is described in detail in 
the section "Halt Function" in Chapter 
15, "Basic I/O Functions." 

Condition code is set to indicate that 
the actions described above have been 
taken. 



Associated Functi ons 



Subsequent to the execution of HALT 
SUBCHANNEL, the channel subsystem 
asynchronously performs the halt func- 
tion. If conditions allow, the channel 
subsystem chooses a channel path and 
attempts to issue the halt signal to the 
device to terminate the I/O operation, 
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if any. The subchannel 
status-pendi ng. 



then becomes 



When the subchannel becomes status- 
pending as a result of performing the 
halt function* data transfer, if any, 
with the associated device has been 
terminated. The SCSW stored when the 
resulting status is cleared by TEST 
SUBCHANNEL has the halt-function bit 
stored as one. If the halt signal was 
issued to the device, the halt-pending 
bit is stored as zero. Otherwise, the 
halt-pending bit is stored as one, and 
other indications are provided that 
describe in greater detail the condition 
that was encountered. (See the section 
"Interruption-Response Block" in Chapter 
16, "I/O Interruptions," and the section 
"Halt Function" in Chapter 15, "Basic 
I/O Functions.") 

In some models, path availability is 
tested as part of the halt function 
(rather than as part of the execution of 
the instruction). In these models, when 
no channel path is available for 
selection, the halt signal is not 
issued, and the subchannel is made 
status-pending. When the status-pending 
condition is subsequently cleared by 
TEST SUBCHANNEL, the halt-pending bit is 
stored as one in the SCSW. 

If a status-pending condition is elimi- 
nated during execution of HALT SUBCHAN- 
NEL, then this condition is 
reestablished along with the other 
status conditions when completion of the 
halt function is indicated to the 
program. 

The halt-pending condition may not be 
recognized by the channel subsystem if a 
status-pending condition has been genet — 
ated. This situation could occur, for 
example, when alert status is presented 
or generated while the subchannel is 
already start-pending or resume-pending, 
or when primary status is presented 
during the attempt to initiate the I/O 
operation for the first command as spec- 
ified by the start function or implied 
by the resume function. If recognition 
of the status-pending condition by the 
channel subsystem has occurred logically 
prior to recognition of the halt-pending 
condition, the SCSW, when cleared by 
TEST SUBCHANNEL, has the halt-pending 
bit stored as one. 

If measurement data is being accumulated 
when a start function is terminated by 
HALT SUBCHANNEL, the measurement data 
continues to be accumulated for the 
subchannel and reflects the extent of 
subchannel and device usage required, if 
any, while performing the currently 
terminated start function. The measure- 
ment data, if any, is accumulated in the 
measurement block for the subchannel or 
placed in the extended-status word, as 



appropriate, when the subchannel becomes 
status-pending with primary status. 
(See the section "Channel-Subsystem 
Monitoring" in Chapter 17, "I/O Support 
Functi ons.") 



Special Condi ti ons 



Condition code 1 is set and no other 
action is taken when the subchannel is 
status-pending alone or is status- 
pending with any combination of alert, 
primary, or secondary status. 

Condition code 2 is set and no other 
action is taken when the subchannel is 
busy for HALT SUBCHANNEL. The subchan- 
nel is busy for HALT SUBCHANNEL when a 
halt function or clear function is 
already in progress at the subchannel. 

Condition code 3 is set and no other 
action is taken when the subchannel is 
not operational for HALT SUBCHANNEL. A 
subchannel is not operational for HALT 
SUBCHANNEL when the subchannel is not 
provided in the channel subsystem, has 
no valid device number assigned to it, 
or is not enabled. In some models, a 
subchannel is also not operational for 
HALT SUBCHANNEL when no channel paths 
are available for selection by the 
device. (See the section "Channel-Path 
Availability" in Chapter 15, "Basic I/O 
Functions," for a description of channel 
paths that are available for selection.) 

HALT SUBCHANNEL can encounter the 
program exceptions listed below. Bit 
positions 0-15 of general register 1 
must contain the value 0001 hex; other — 
wise, an operand exception is 
recogni zed. 



other than 



Resulti ng Condi ti on Code : 

Function initiated 

1 Status-pending with 
intermediate status 

2 Busy 

3 Not operational 

Program Except i ons ? 

Operand 

Privileged operation 



Programmi ng Note 



After execution of HALT SUBCHANNEL, the 
status-pending condition indicating the 
completion of the halt function may be 
extended period of time, 
when the device is a 
unit executing a rewind 



delayed for an 
for example, 
magneti c-tape 
command. 
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MODIFY SUBCHANNEL 



MSCH D 2 (B a ) 
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The information contained in the 
subchannel-information block (SCHIB) is 
placed in the program-modifiable fields 
of the subchannel. As a result, the 
program influences, for that subchannel, 
certain aspects of I/O processing rela- 
tive to the clear, halt, resume, and 
start functions and certain I/O support 
functi ons. 



General regi ster 1 
subsystem- i denti f i cat i on 
designates the subchannel 
modified as specified by 
of the SCHIB. The 
address is the logical 



contains the 
word, which 
that is to be 
certain fields 
second-operand 
address of the 



SCHIB 
ary . 



and is designated on a word bound- 



The channel-subsystem operations that 
may be influenced due to placement of 
SCHIB information in the subchannel bvqi 

(1) I/O processing (E field), 

(2) interruption processing (interrup- 
tion parameter and ISC field), (3) path 
management (D, LPM, and POM fields), and 
(4) monitoring and address-limit- 
checking facilities (measurement-block 
index and LM and MM fields). Bits 0-1 
and 5-7 of word 1 and bits 0-31 of word 
6 of the SCHIB operand must be specified 
as zeros, and bits 9-10 of word 1 must 
not both be ones. The remaining fields 
of the SCHIB are ignored and do not 
affect the processing of MODIFY SUBCHAN- 
NEL. (For further details, see the 
section "Subchannel-Information Block" 
in Chapter 15, "Basic I/O Functions.") 

Condition code is set to indicate that 
the information from the SCHIB has been 
placed in the program-modifiable fields 
of the subchannel. 



Special Condi ti ons 



Condition code 1 is set and no other 
action is taken when the subchannel is 
status-pending. (See the section "Sta- 
tus Control" in Chapter 16, "I/O Inter- 
rupt i ons.") 

Condition code 2 is set and no other 
action is taken when a clear, halt, or 
start function is in progress at the 
subchannel. (See the section "Function 
Control" in Chapter 16, "I/O Inter- 
rupt i ons.") 



Condition code 3 is set and no other 
action is taken when the subchannel is 
not operational for MODIFY SUBCHANNEL. 
A subchannel is not operational for 
MODIFY SUBCHANNEL when the subchannel is 
not provided in the channel subsystem. 

MODIFY SUBCHANNEL can encounter the 
program exceptions listed below. In 
word 1 of the SCHIB, bits 0-1 and 5-7 
must be zeros, and bits 9 and 10 must 
not both be ones; in word 6 of the 
SCHIB, bits 0-31 must be zeros; bits 
0-15 of general register 1 must contain 
the value 0001 hex; otherwise, an oper- 
and exception is recognized. 

The execution of MODIFY SUBCHANNEL is 
suppressed on all addressing and 
protection exceptions. 

The second operand must be designated on 
a word boundary; otherwise, a specifica- 
tion exception is recognized. 

Resulti ng Condi t i on Code ? 

SCHIB information placed in 
subchannel 

1 Status-pending 

2 Busy 

3 Not operational 

Program Excepti ons ? 

Access (fetch, operand 2) 

Operand 

Privileged operation 

Speci f i cati on 



Proqrammi ng Note 



If a device signals I/0-error alert 
while the associated subchannel is disa- 
bled, the channel subsystem issues the 
clear signal to the device and discards 
the I/0-erroi — alert indication without 
generating an I/O-i nterrupti on condi- 
ti on. 

If a device presents unsolicited status 
while the associated subchannel is disa- 
bled, that status is discarded by the 
channel subsystem without generating an 
I/O-i nterrupti on condition. However, if 
the status presented contains unit 
check, the channel subsystem issues the 
clear signal for the associated subchan- 
nel and does not generate an 1/0- 
interruption condition. This should be 
taken into account when the program uses 
MODIFY SUBCHANNEL to enable a 
subchannel. For example, the medium on 
the associated device that was present 
when the subchannel became disabled may 
have been replaced, and, therefore, the 
program should verify the integrity of 
that medium. 
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RESET CHANNEL PATH 



RCHP 
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The channel-path-reset facility is 
signaled to perform the channel-path- 
reset function at the designated channel 
path. 

General register 1 contains* in bit 
positions 24-31, the channel-path iden- 
tifier (CHPID) of the channel path on 
which the channel-path-reset function is 
to be performed. Bit positions 0-23 of 
general register 1 are reserved and must 
contain zeros; otherwise, an operand 
exception is recognized. 

GR1 



0000 0000 0000 0000 0000 0000 CHPID 



24 31 

If conditions allow, the channel-path- 
reset facility is signaled to asynchro- 
nously perform the channel-path-reset 
function on the designated channel path. 
The channel-path-reset function is 
summarized below in the section "Associ- 
ated Functions" and is described in 
detail in the section "Channel-Path 
Reset" in Chapter 17, "I/O Support Func- 
tions." 



Condition code 
the channel-path- 
si gnaled. 



is set to indicate that 
reset facility has been 



Associated Functi ons 



Subsequent to the execution of RESET 
CHANNEL PATH, the channel-path-reset 
facility asynchronously performs the 
channel-path-reset function. Certain 
indications are reset at all subchannels 
that have access to the designated chan- 
nel path, and the reset signal is issued 
on that channel path. Any I/O functions 
in progress at the devices are reset, 
but only for the channel path on which 
the reset signal is received. An I/O 
operation or chain of I/O operations 
taking place in multipath mode may be 
able to continue to execute on other 
channel paths in the multipath group, if 
any. (See the section "Channel-Path- 
Reset Function" in Chapter 15, "Basic 
I/O Functions.") 

The result of performing the channel- 
path-reset function on the designated 
channel path is communicated to the 
program by means of a channel report 



(see the section "Channel Report" in 
Chapter 17, "I/O Support Functions"). 



Special Condi ti ons 



Condition code 2 is set and no other 
action is taken when, on some models, 
the channel-path-reset facility is busy 
performing the channel-path-reset func- 
tion for a previous execution of the 
RESET CHANNEL PATH instruction. 

Condition code 3 is set and no other 
action is taken when, on some models, 
the designated channel path is not opei — 
ational for the execution of RESET CHAN- 
NEL PATH. On these models, the channel 
path is not operational for the 
execution of RESET CHANNEL PATH when the 
designated channel path is not phys- 
ically available. 

If the channel-path-reset facility is 
busy and the designated channel path is 
not physically available, it depends on 
the model whether condition code 2 or 3 
is set. 

RESET CHANNEL PATH can encounter the 
program exceptions listed below. Bit 
positions 0-15 of general register 1 
must contain the value 0001 hex; other- 
wise, an operand exception is 
recogni zed. 

Resulti ng Condi ti on Code ? 

Function initiated 



Busy 

Not operational 



Program Excepti ons ? 

Operand 

Privileged operation 



Programming Notes 



1. To eliminate the possibility of a 
data-integrity exposure for devices 
that have the capability of gener- 
ating unsolicited device-end 
status, I/O operations in progress 
with such devices on the channel 
path for which RESET CHANNEL PATH 
i s to be executed must be termi- 
nated by execution of either HALT 
SUBCHANNEL or CLEAR SUBCHANNEL. 
Otherwise, subsequent to receiving 
the reset signal, the device may 
present an unsolicited device end 
that may be interpreted by the 
channel subsystem as a solicited 
device end and cause command chain- 
ing to occur. 
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If the status-verification facility 
is being used and RESET CHANNEL 
PATH is executed without first 
stopping all ongoing operations 
associated with the channel path 
being reset, erroneous device- 
status-check conditions may be 
detected. 



RESUME SUBCHANNEL 



RSCH 



0/ then it is unpredictable whether 
execution of the current program is 
resumed or whether it is found by the 
resume function that the subchannel has 
become suspended in the interim. The 
subchannel is found to be suspended by 
the resume function only if the subchan- 
nel is status-pending with intermediate 
status when the resume-pending condition 
is recognized by the channel subsystem. 
(See the section "Start Function and 
Resume Function" in Chapter 15, "Basic 
I/O Functions.") 
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The channel subsystem is signaled to 
perform the resume function at the 
designated subchannel. 

General register 1 contains the 
subsystem-identification word, which 
designates the subchannel at which the 
resume function is to be performed. 

I The subchannel is made resume-pending. 

Logically prior to the setting of condi- 
tion code and only if the subchannel 
is currently in the suspended state, 
path-not-operational conditions at the 
subchannel, if any, are cleared. 

The channel subsystem is signaled to 
asynchronously perform the resume func- 
tion. The resume function is summarized 
below in the section "Associated Func- 
tions" and is described in detail in the 
section "Start Function and Resume Func- 
tion" in Chapter 15, "Basic I/O 
Functi ons." 



to indicate 
above have 



that 
been 



Condition code is set 
the actions described 
taken. 



Associated Functions 



Subsequent to the execution of RESUME 
SUBCHANNEL, the channel subsystem 
asynchronously performs the resume func- 
tion. Except when the subchannel is 
subchannel-active, if the execution of 
RESUME SUBCHANNEL results in the setting 
of condition code 0, performance of the 
resume function causes execution of a 
currently suspended channel program to 
be resumed with the associated device, 
provided that the suspend flag for the 
current CCUI has been set to zero by the 
program. If the suspend flag remains 
set to one, execution of the channel 
program remains suspended. But, if the 
subchannel is subchannel-active at the 
time the execution of RESUME SUBCHANNEL 
results in the setting of condition code 



Special Condi tions 



Condition code 1 is set 
action is taken when the 
statu s-pendi ng. 



and no other 
subchannel i s 



Condition code 2 is set and no other 
action is taken when the resume function 
is not applicable. The resume function 
is not applicable when the subchannel 
(1) has any function other than the 
start function alone specified, (2) has 
no function specified, (3) is resume- 
pending, or (4) does not have suspend 
control specified for the start function 
in progress. 

Condition code 3 is set and no other 
action is taken when the subchannel is 
not operational for the resume function. 
A subchannel is not operational for the 
resume function if the subchannel is not 
provided in the channel subsystem, has 
no valid device number assigned to it, 
or is not enabled. 

RESUME SUBCHANNEL can encounter the 
program exceptions listed below. Bit 
positions 0-15 of general register 1 
must contain the value 0001 hex; othei — 
wise, an operand exception is 
recogni zed. 

Resulti ng Condi ti on Code : 

Function initiated 

1 Status-pending 

2 Function not applicable 

3 Not operational 

Program Excepti ons ? 

Operand 

Privileged operation 



Programmi ng Notes 



1. When channel-program execution is 
resumed from the suspended state, 
the device views the resumption as 
the beginning of a new chain of 
commands. When the suspension of 
channel-program execution occurs 
and the device requires that 
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certain commands be first or appear 
only once in a chain of commands 
(for example, direct-access-storage 
devices), the program must ensure 
that the appropriate commands in 
the proper sequence are fetched by 
the channel subsystem after 
channel-program execution is 
resumed. One way the program can 
ensure proper sequencing of 
commands at the device is by allow- 
ing the I/O interruption to occur 
for an intermediate interruption 
condition due to suspension. 

It is not reliable to notify the 
program that the subchannel i s 
suspended by using the PCI flag in 
the CCW that contains the S flag 
because the PCI I/O interruption 
may occur before the subchannel i s 
suspended. The SCSW would indicate 
that an I/O operation is in 
progress at the subchannel and 
device in this case. 

The suspend flag of the target CCW 
should be set to zero before RESUME 
SUBCHANNEL is executed; otherwise, 
it is possible that the resume- 
pending condition may be recognized 
and the CCW refetched while the 
suspend flag is still one, in 
which case the resume-pending 
condition would be reset, and the 
execution of the channel program 
would be suspended. If the suspend 
flag of the target CCW is set to 
zero before the execution of RESUME 
SUBCHANNEL, the channel program is 
not suspended, provided that the 
subchannel is not subchannel-active 
at the time the execution of RESUME 
SUBCHANNEL results in the setting 
of condition code 0. If condition 
code is set while the subchannel 
is still subchannel-active, it is 
unpredictable whether the resume- 
pending condition is recognized by 
the channel subsystem or whether it 
is found by the resume function 
that the subchannel has become 
suspended in the interim. The 
subchannel is found to be suspended 
by the resume function only if the 
subchannel is status-pending with 
intermediate status at the time the 
resume-pending condition is recog- 
nized. When the subchannel is 
suspended, the execution of TEST 
SUBCHANNEL, which clears the inter- 
mediate interruption condition, 
also clears the indication of 
resume-pendi ng. 

Some models recognize a resume- 
pending condition only after a CCW 
having a valid S flag set to one is 
fetched. Therefore, if a subchan- 
nel is resume-pending and, during 
execution of the channel program, 
no CCW is fetched having a valid S 
flag set to one, the subchannel 
remains resume-pending until the 



primary 
cleared 



interruption condition 
by TEST SUBCHANNEL. 



1 s 



3. Path availability is not tested 
during the execution of RESUME 
SUBCHANNEL. Instead, path avail- 
ability is tested when the channel 
subsystem begins performance of the 
resume function. 

4. The contents of the CCW fetched 
during performance of the resume 
function may be different from the 
contents of the same CCW when it 
was previously fetched and 
contained a valid S flag. 



SET ADDRESS LIMIT 
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The 



address-limit-checking facility is 
signaled to use the specified address as 
the address-limit value, and the speci- 
fied address is passed to the facility. 

General register 1 contains the address 
to be used as the address-limit value. 
The address is designated on a 64K-byte 
boundary, and the leftmost bit of gener- 
al register 1 is zero. 

GR1 



Address-Limit Value 



31 



Associated Functi ons 



The value that is used by th 
limit-checking facility when d 
whether to permit or prohib 
access is called the add 
value. The initialized add 
value is zero. The initial 
limit value is used by the 
limit-checking facility u 
facility recognizes a signal 
the execution of SET ADDRESS 
use a specified address. Th 
tion of this specified addre 
new address-limit value occurs 
nously with respect to the ex 
SET ADDRESS LIMIT. 



e address- 

etermi ni ng 

it a data 

ress-limi t 

ress-limi t 

address- 

address- 

ntil the 

(caused by 

LIMIT) to 

e recogni- 

ss as the 

asynchro- 

ecution of 



If address-limit checking is specified 
for a subchannel, then whether the spec- 
ified address is used by the address- 
limit-checking facility (when 
determining whether to permit or prohib- 
it a data access) depends on whether SET 
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ADDRESS LIMIT was executed before* 
during^ or after the execution of START 
SUBCHANNEL for that subchannel. If SET 
ADDRESS LIMIT is executed before START 
SUBCHANNEL, then the specified address 
is used by the address-limit-checking 
facility. If SET ADDRESS LIMIT is 
executed during or after the execution 
of START SUBCHANNEL, then it is unpre- 
dictable whether the specified address 
is used by the address-limit-checking 
facility for that particular start func- 
tion. For a description of the manner 
in which address-limit checking is 
performed, see the section "Address- 
Limit Checking" in Chapter 17, "I/O 
Support Functions." 



Special Condi ti ons 



SET ADDRESS LIMIT can encounter the 
program exceptions listed below. The 
address in general register 1 must be 
designated on a 64K-byte boundary, and 
the leftmost bit of general register 1 
must be zero; otherwise, an operand 
exception is recognized. 



GR1 



Condi t ion 
unchanged. 



Code 



The code 



remains 



Program Excepti ons : 

Operand 

Privileged operation 



SET CHANNEL MONITOR 



SCHM 



MBK 


00000000000000000000000000 


M 


D 




GR2 



30 31 



MBO Address 



m 



1 31 

Bit positions 0-3 of general register 1 
contain the measurement-block key (MBK). 
When bit 30 is one, MBK specifies the 
access key that is to be used by the 
channel subsystem when it accesses the 
measurement-block area. Otherwise, bit 
positions 0-3 of general register 1 are 
ignored. 

Bit positions 4-29 of general register 1 
contain zeros. 

Bit 30 (M) of general register 1 is the 
measurement-mode-control bit that 
controls the measurement-block-update 
mode. When bit 30 of general register 1 
is one and conditions allow, the 
measurement-block-update facility is 
signaled to asynchronously make the 
measurement-block-update mode active. 
In addition, the MBO address (in general 
register 2) and the measurement-block 
key (MBK) (in general register 1) are 
passed to the measurement-block-update 
Furthermore, when bit 30 i s 
of general register 2 must be 
asynchronous functions that 
are performed by the measurement-block- 
update facility are summarized below in 
the section "Associated Functions" and 
are described in detail in the section 
"Channel-Subsystem Monitoring" in Chap- 
ter 17, "I/O Support Functions." 



faci li ty. 
one, bit 
zero. The 



'B23C 


//////////////// 



16 

The monitoring mode 
subsystem are made 
inactive, depending 
the measurement-mode 
general register 1. 
setting of the measu 
bit for measurement 
channel subsystem i s 
the mode active, or 
inactive. Depending 
the measurement-mode 
device-connect time, 
active or inactive. 



31 

s of the channel 
either active or 

on the setting of 

control bits in 

Depending on the 

rement-mode-control 

block update, the 

signaled to make 

the mode i s made 

on the setting of 

-control bit for 
the mode i s made 



General registers 1 and 2 have the 
following format: 



When bit 30 of general register 1 is 
zero and conditions allow, the 
measurement-block-update mode is made 
inactive if it is active or remains 
inactive if it is inactive. The 
contents of bit positions 0-3 (MBK) of 
general register 1 and the contents of 
general register 2 are ignored. 

Bit 31 (D) of general register 1 is the 
measurement-mode-control bit that con- 
trols the devi ce-connect-time-measure- 
ment mode. When bit 31 is one and 
conditions allow, the devi ce-connect- 
time-measurement mode is made active if 
it is inactive or remains active if it 
is active. When bit 31 is zero and 
conditions allow, the devi ce-connect- 
time-measurement mode is made inactive 
if it is active or remains inactive if 
it is inactive. 

Bit of general register 2 must be zero 
when bit 30 (M) of general register 1 is 
one; otherwise, an operand exception is 
recognized. When bit 30 (M) of general 
register 1 is zero, bit of general 
register 2 is ignored. Bit positions 
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1-31 of general register 2 contain the 
absolute address of the measurement- 
block origin (MBO). When bit 30 (M) of 
general register 1 is one; the MBO 
address designates the beginning of the 
measurement-block area. The origin of 
the measurement-block area must be 
designated on a 32-byte boundary. The 
MBO address is used by the channel 
subsystem to locate measurement blocks. 
When bit 30 (M) of general register 1 is 
zero* the contents of general register 2 
are ignored. 

If the channel-subsystem timer that is 
used by the channel-subsystem monitoring 
facilities is in the error state, the 
state is reset. This happens independ- 
ent of the setting of the two 
measurement-mode-control bits. (See the 
section "Channel-Subsystem Timing" in 
Chapter 17, "I/O Support Functions.") 



Associated Functi ons 



When the measurement-block-update facil- 
ity is signaled (by means of SET CHANNEL 
MONITOR) to make the measurement-block- 
update mode active, the functions that 
are performed by the facility depend on 
whether or not the mode is already 
active when the signal is generated. 

If the measurement-block-update mode i s 
inactive when the signal is generated, 
the mode remains inactive until the 
measurement-block-update facility recog- 
nizes the signal. When the measure- 
ment-block-update facility recognizes 
the signal, the measurement-block-update 
mode is made active, and the MBK and MBO 
associated with that signal (that is, 
the MBK and MBO that were passed when 
the signal was generated) are used to 
control the storing of measurement data. 

If the measurement-block-update mode i s 
active when the signal is generated, the 
mode remains active, and the MBK and MBO 
associated with the execution of a 
previous SET CHANNEL MONITOR instruction 
continue to be used to control the stor- 
ing of measurement data until the 
measurement-block-update facility recog- 
nizes the signal. When the measure- 
ment-block-update facility recognizes 
the signal, the MBK and MBO associated 
with that signal are used instead of the 
MBK and MBO associated with the 
execution of a previous SET CHANNEL 
MONITOR instruction. 

In either of the above cases, the 
measurement-block-update facility recog- 
nizes the signal during, or subsequent 
to, the execution of the SET CHANNEL 
MONITOR instruction that caused the 
signal to be generated and logically 
prior to the performance of any start 



function that is initiated by the subse- 
quent execution of START SUBCHANNEL for 
a subchannel that i s enabled for meas- 
urement by this facility. If a 
subchannel that i s enabled for measure- 
ment by this facility already has a 
start function in progress when the 
signal is generated, it is unpredictable 
when measurement data for that subchan- 
nel is stored by using the MBK and MBO 
associated with that signal. 

While the measurement-block-update mode 
is active, performance measurements are 
accumulated for subchannels that are 
enabled for measurement-block update. 
Measurements for a subchannel are accu- 
mulated in a single 32-byte measurement 
block within the measurement-block area. 
A subchannel is enabled for the 
measurement-block-update mode by setting 
the measurement-block-update-enable bit 
to one in the SCHIB and then executing 
MODIFY SUBCHANNEL for that subchannel. 
The measurement block that i s used to 
accumulate measurements for a subchannel 
is determined by the measurement-block 
index that is contained in the subchan- 
nel . 

When the devi ce-connect-time-measurement 
mode is active, measurements of the 
length of time that the device is 
actively communicating with the channel 
subsystem during the execution of a 
channel program are accumulated for 
subchannels that are enabled for 
devi ce-connect-time measurement. Meas- 
urements for a subchannel are provided 
in the ESW of the IRB. A subchannel is 
enabled for devi ce-connect-time- 
measurement mode by setting the device- 
connect-time-measurement-enable bit to 
one in the SCHIB and then executing 
MODIFY SUBCHANNEL for that subchannel. 

For a more detailed description of the 
measurement-block-update mode, the 
format and contents of the measurement 
block, and the devi ce-connect-time- 
measurement mode, see the section 
"Channel-Subsystem Monitoring" in Chap- 
ter 17, "I/O Support Functions." 



Special Condi ti ons 



SET CHANNEL MONITOR can encounter the 
program exceptions listed below. Bits 
4-29 of general register 1 must be 
zeros; the MBO address must be desig- 
nated on a 32-byte boundary when bit 30 
(M) of general register 1 is one; and 
bit of general register 2 must be zero 
when bit 30 (M) of general register 1 is 
one; otherwise, an operand exception is 
recogni zed. 



Condition 
unchanged. 



Code ? The code remains 
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Program Excepti ons ' 



Associated Functi ons 



Operand 

Privileged operation 



Programmi ng Note 



When the channel subsystem is initial- 
ized, the measurement-block-update and 
devi ce- connect- time-measurement modes 
are made inactive. 



START SUBCHANNEL 



SSCH D 2 (B 2 ) 



CS] 
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The channel subsystem is signaled to 
asynchronously perform the start func- 
tion for the associated device, and the 
execution parameters that are contained 
in the designated ORB are placed at the 
designated subchannel. (See the section 
"Operation-Request Block" in Chapter 15, 
"Basic I/O Functions.") 

General register 1 contains the 
subsystem-identification word, which 
designates the subchannel that is to be 
started. The second-operand address is 
the logical address of the ORB and is 
designated on a word boundary. 



The execution parameters contained 
the ORB are placed at the subchannel, 



l n 



In some models, when START SUBCHANNEL is 
executed and the subchannel is status- 
pending with only secondary status, the 
status-pending condition is discarded at 
the subchannel . 

| The subchannel is made start-pending, 
| and the start function is indicated at 
I the subchannel. 

Logically prior to the setting of condi- 

| tion code 0, path-not-operati onal condi- 

| tions at the subchannel, if any, are 

cleared. 

The channel subsystem is signaled to 
asynchronously perform the start func- 
tion. The start function is summarized 
below in the section "Associated Func- 
tions" and is described in detail in the 
section "Start Function and Resume Func- 
tion" in Chapter 15, "Basic I/O 
Functi ons." 

Condition code is set to indicate that 
the actions described above have been 
taken. 



Subsequent to the execution of START 
SUBCHANNEL, the channel subsystem 
asynchronously performs the start func- 
ti on. 

The contents of the ORB, other than the 
fields that must contain all zeros, are 
checked for validity. In some models, 
the fields of the ORB that must contain 
zeros are also checked asynchronously 
(rather than during the execution of the 
instruction). When invalid fields are 
detected asynchronously, the subchannel 
becomes status-pending with primary, 
secondary, and alert status and with 
deferred condition code 1 and program 
check indicated. (See the section "Pro- 
gram Check" in Chapter 16, "I/O 
Interruptions.") In this situation, the 
I/O operation or chain of I/O operations 
is not initiated at the device, and the 
condition is indicated by the start- 
pending bit being stored as one when the 
SCSW is cleared by the execution of TEST 
SUBCHANNEL. (See the section 
"Subchannel-Status Word" in Chapter 16, 
"I/O Interruptions."). 

In some models, path availability is 
tested asynchronously (rather than as 
part of the execution of the 
instruction). When no channel path is 
available for selection, the subchannel 
becomes status-pending with primary and 
secondary status and with deferred 
condition code 3 indicated. The I/O 
operation or chain of I/O operations is 
not initiated at the device, and this 
condition is indicated by the start- 
pending bit being stored as one when the 
SCSW is cleared by the execution of TEST 
SUBCHANNEL. 

If conditions allow, a channel path is 
chosen and execution of the channel 
program that is designated in the ORB is 
initiated. (See the section "Start 
Function and Resume Function" in Chapter 
15, "Basic I/O Functions.") 



Special Condi ti ons 



Condition code 1 is set and no other 
action is taken if the subchannel is 
status-pending when START SUBCHANNEL is 
executed. In some models, condition 
code 1 i s not set when the subchannel i s 
status-pending with only secondary 
status; instead, the status-pending 
condition is discarded. 

Condition code 2 is set and no other 
action is taken when a start, halt, or 
clear function is currently in progress 
at the subchannel (see the section 
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"Function Control" 
Interruptions") . 



in Chapter 16, "I/O 



STORE CHANNEL PATH STATUS 



Condition code 3 is set and no other 
action is taken when the subchannel is 
not operational for START SUBCHANNEL. A 
subchannel is not operational for START 
SUBCHANNEL if the subchannel is not 
provided in the channel subsystem/ has 
no valid device number assigned to it, 
or is not enabled. 

A subchannel is also not operational for 
START SUBCHANNEL, in some models, when 
no channel path is available for 
selection. In these models, the lack of 
an available channel path is detected as 
part of START SUBCHANNEL execution. In 
other models, channel path availability 
is only tested as part of the asynchro- 
nous start function. 



START SUBCHANNEL can 
program exceptions lis 
execution of START 
suppressed on all 
protection exceptions. 
ORB, bits 5-7, 13-15, 
zeros, in word 2 of th 
be 0; otherwise, in 
operand exception is 
other models, an I/O-in 
tion is generated in 
check as part of the a 
functi on. 



encounter the 

ted below. The 

SUBCHANNEL is 

addressing and 

In word 1 of the 

and 25-31 must be 

e ORB, bit must 

some models, an 

recognized. In 

terruption condi- 

dicating program 

synchronous start 



Bits 0-15 of general register 1 must 
contain 0001 hey:; when the incorrect- 
length- i ndi cat i on-suppressi on faci 1 i ty 
is not installed, bit 24 of word 1 of 
the ORB must be zero; otherwise, an 
operand exception is recognized. 

The second operand must be designated on 
a word boundary; otherwise, a specifica- 
tion exception is recognized, and the 
execution of START SUBCHANNEL is 
suppressed. 

Resulti ng Condi ti on Code: 

Function initiated 

1 Status-pending 

2 Busy 

3 Not operational 

Program Exceptions ? 

Access (fetch, operand 2) 

Operand 

Privileged operation 

Speci f i cati on 
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A channel-path-status word of up to 256 

bits is stored at the designated 
locati on . 

The second-operand address i s the 
logical address of the location where 

the channel-path-status word i s to be 

stored and is designated on a 32-byte 
boundary. 



The channel-path-status word indicates 
which channel paths are actively commu- 
a device at the time STORE 
STATUS is executed. Bit 
0-255 correspond, 
to the channel paths 
channel-path identifiers 
of the 256 bits at the 
designated location is set to one, set 
to zero, or left unchanged, as follows: 



nicating with 
CHANNEL PATH 
positions 
respecti vely, 
having the 
0-255. Each 



For all channel paths in the 
configuration that are actively 
communicating with devices at the 
time STORE CHANNEL PATH STATUS is 
executed, the corresponding bits 
are stored as ones. 

For all channel paths that are 
(1) provided in the system (PIM bit 
in the SCSW is one) and (2) in the 
configuration, but not currently 
being used by the channel subsystem 
in actively communicating with 
devices, the corresponding bits are 
stored as zeros. 

For all channel paths that are not 
provided in the system (PIM bit in 
the SCSW is zero), the correspond- 
ing bits either are not stored or 
are stored as zeros. 

For all channel paths in the 
configuration that are in the 
channel-path-terminal state or are 
not physically available (the 
corresponding PAM bit in the SCSW 
is zero), the corresponding bits 
are stored as zeros. 



Special Condi ti ons 



STORE CHANNEL PATH STATUS can encounter 
the program exceptions listed below. 
The execution of STORE CHANNEL PATH 
STATUS is suppressed on all addressing 
and protection exceptions. The second 
operand must be designated on a 32-byte 
boundary; otherwise, a specification 
exception is recognized. 
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Condi ti on 
unchanged. 



Code: 



The 



code 



remai ns 



Program Exceptions ? 

Access (store, operand 2) 
Privileged operation 
Speci f i cati on 



Programmi ng Note 



To ensura a consistent interpretation of 
channel-path-status-word bits, the 
program should, prior to the initial use 
of the area, store zeros at the location 
where the channel-path-status word is to 
be stored. 



STORE CHANNEL REPORT WORD 



Special Condi ti ons 



STORE CHANNEL REPORT WORD can encounter 
the program exceptions listed below. 
The execution of STORE CHANNEL REPORT 
WORD is suppressed on all addressing and 
protection exceptions. The second opei — 
and must be designated on a word 
boundary; otherwise, a specification 
exception is recognized. 

Resulti ng Condi ti on Code : 

CRW stored 

1 Zeros stored 
2 

3 



Program Excepti ons ? 

Access (store, operand 
Privileged operation 
Speci f icati on 



2) 
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A CRW containing information affecting 
the channel subsystem i s stored at the 
designated location. 

The second-operand address is the 
logical address of the location where 
the CRW is to be stored and is desig- 
nated on a word boundary. 

When a malfunction or other condition 
affecting channel-subsystem operation is 
recognized, a channel report (consisting 
of one or more CRWs) describing the 
condition is made pending for retrieval 
and analysis by the program. The chan- 
nel report contains information 
concerning the identity and state of a 
facility of the channel subsystem 
following the detection of the malfunc- 
tion or other condition. For a 
description of the channel report, the 
program-recovery actions 
the channel subsystem, see 
"Channel-Subsystem Recovery" 



CRW, and 
related to 
the section 



in Chapter 17, "I/O Support Functions." 

When one or more channel reports are 
pending, the instruction causes a CRW to 
be stored at the designated location and 
condition code to be set. A pending 
CRW can only be stored by executing 
STORE CHANNEL REPORT WORD and, once 
stored, is no longer pending. Thus, 
each pending CRW is presented only once 
to the program. 

When no channel reports are pending in 
the channel subsystem, execution of 
STORE CHANNEL REPORT WORD causes zeros 
to be stored at the designated location 
and condition code 1 to be set. 



Programmi ng Notes 



CRW overflow condition 
if STORE CHANNEL REPORT 
executed to clear pend 
reports. If the overfl 
is encountered, one 
channel-report words 
lost. (See the sectio 
Subsystem Recovery" in 
"I/O Support Funct 
detai Is. ) 



s may occur 
WORD is not 

ing channel 

ow condition 
or more 
have been 

n "Channel- 
Chapter 17, 

ions," for 



A pending CRW can be cleared by any 
CPU in the configuration executing 
STORE CHANNEL REPORT WORD, regard- 
less of whether a machine-check 
interruption has occurred in any 
CPU. 



STORE SUBCHANNEL 
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Control and status information for the 
designated subchannel is stored in the 
designated SCHIB. 



General register 1 
subsystem-i denti f i cat i on 
designates the subchannel 
information is to be 
second-operand address i s 
address of the SCHIB and 
on a word boundary. 



contains the 
word, which 
for which the 
stored. The 
the logical 
is designated 
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The information that is stored in the 
SCHIB consists of the path- management- 
control word, the SCSW, and three words 
of model-dependent information. (See 
the section "Subchannel-Information 
Block" in Chapter 15, "Basic I/O Func- 
tions.") 

The execution of STORE SUBCHANNEL does 
not change any information contained in 
the subchannel. 

Condition code is set to indicate that 
control and status information for the 
designated subchannel has been stored in 
the SCHIB. Whenever the execution of 
STORE SUBCHANNEL results in the setting 
of condition code 0, the information in 
the SCHIB indicates a consistent state 
of the subchannel . 



Special Condi ti ons 



Condition code 3 is set and no other 
action is taken when the designated 
subchannel is not operational for STORE 
SUBCHANNEL. A subchannel is not opera- 
tional for STORE SUBCHANNEL if the 
subchannel is not provided in the chan- 
nel subsystem. 

STORE SUBCHANNEL can encounter the 
program exceptions listed below. Bit 
positions 0-15 of general register 1 

the value 0001 hex; other- 
operand exception is 

The second operand must be 

on a word boundary? 

specification exception is 



must contain 
wise, an 
recogni zed. 
desi gnated 
otherwi se, a 
recogni zed. 



Resulti ng Condi ti on Code' 



SCHIB stored 



3 Not operational 

Program Excepti ons ? 

Access (store, operand 2) 

Operand 

Privileged operation 

Speci f i cati on 



Programmi ng Notes 



Device status that is stored in the 
SCSW may include device-busy, 
control-unit-busy, or control- 
unit-end indications. 

The information that is stored in 
the SCHIB is obtained from the 
subchannel. The STORE SUBCHANNEL 
instruction does not cause the 
channel subsystem to interrogate 
the addressed device. 



STORE SUBCHANNEL may be executed at 
any time to sample conditions 
existing at the subchannel, without 
causing any pending status condi- 
tions to be cleared. 

Repeated execution of STORE SUB- 
CHANNEL without an intervening 
delay (for example, to determine 
when a subchannel changes state) 
should be avoided because repeated 
accesses of the subchannel by the 
CPU may delay or prohibit access of 
the subchannel by the channel 
subsystem to update the subchannel. 



TEST PENDING INTERRUPTION 
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The interruption code for a pending 
interruption at the subchannel is stored 
at the designated location, and the 
pending interruption request is cleared. 

The second-operand address, when 
nonzero, is the logical address of the 
location where the interruption code is 
to be stored and is designated on a word 
boundary. 

If the second-operand address is zero, 
the interruption code is stored at real 
locations 184-191. 

In this case low-address protection and 
key-controlled protection do not apply. 

Pending interruption requests are 
accepted only for those I/O-interrupt i on 
subclasses allowed by the 1/0- 
interruption subclass mask in control 
register 6 of the CPU executing the 
instruction. If no I/O-i nterrupti on 
requests exist that are allowed by 
control register 6, the interruption 
code is not stored, the second-operand 
location is not modified, and condition 
code is set. 

If a pending interruption request is 
accepted, the interruption code is 
stored, the pending interruption request 
is cleared, and condition code 1 is set. 
The interruption code that is stored is 
the same as would be stored if an I/O 
interruption had occurred. However, 
PSWs are not swapped, as when an intei — 
ruption occurs. 

The interruption code that is stored 
during execution of the instruction is 
defined as follows: 
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Word 
1 



Subsystem-Identification Word 



Interruption Parameter 



TEST SUBCHANNEL 



31 



Subsystem-Identi fi cation Word : See the 
section "I/O-Instruct i on Formats" in 
this chapter. 

Interrupti on Parameter ? Word 1 contains 
a foui — byte parameter which is specified 
by the program and which previously was 
passed to the subchannel in word of 
the ORB or the PMCW. When a device 
presents alert status and the intei — 
ruption parameter was not passed 
previously to the subchannel by execut- 
ing START SUBCHANNEL or MODIFY 
SUBCHANNEL, this field contains zeros. 



Special Condi t i ons 



TEST PENDING INTERRUPTION can encounter 
the program exceptions listed below. 
The execution of TEST PENDING INTER- 
RUPTION is suppressed on all addressing 
and protection exceptions. The second 
operand must be designated on a word 
boundary; otherwise, a specification 
exception is recognized. 

Resuiti ng Condi ti on Code ? 



Interruption code not stored 
Interruption code stored 



Program Excepti ons ? 

Access (store, operand 2, second- 
operand address nonzero only) 
Privileged operation 
Speci f i cati on 



Programming Note 



TEST PENDING 
second-operand a 
only be executed 
are masked off. 
ruption code sto 
may be lost i 
occurs. The in 
identifies the 
ruption is stor 
184-191, replaci 
stored by the ins 



INTERRUPTION with a 
ddress of zero should 
when I/O interruptions 
Otherwise, an inter- 
red by the instruction 
f an I/O-i nterrupti on 
terruption code that 
source of the intei — 
ed at real locations 
ng the code that is 
truct i on. 
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Control and status information for the 
subchannel is stored in the designated 
IRB. 



General register 1 
subsystem-i dent i f i cati on 
designates the subchannel 
information is to be 
second-operand address i s 



address of the IRB 
a word boundary. 



contains the 
word, which 
for which the 
stored. The 
the logical 



and is designated on 



The information that is stored in the 
IRB consists of the SCSW, the extended- 
status word, and the extended-control 
word. (See the section "Interruption- 
Response Block" in Chapter 16, "I/O 
Interrupti ons.") 

If the subchannel is status-pending, the 
status-pending bit of the status-control 
field is stored as one. Whether or not 
the subchannel is status-pending has an 
effect on the functions that are 
performed when TEST SUBCHANNEL is 
executed. 



When the subchannel 
and TEST SUBCHANNEL 
mation (as described 
the IRB, followed 
certain conditions a 
exist at the subchan 
the figure "Condi ti 
Cleared at the S 
SUBCHANNEL"). If 
request is pending 
the request is clea 
is set to indicat 
have been taken. 



is status 
i s executed 
above) i s s 
by the clea 
nd indicati 
nel (as desc 
ons and Ind 
ubchannel 

an inte 
for the sub 
red. Condit 
e that these 



-pendi ng 
, infoi — 
tored in 
ring of 
ons that 
ribed in 
i cati ons 
by TEST 
rruption 
channel, 
ion code 
actions 



When the subchannel is not status- 
pending and TEST SUBCHANNEL is executed, 
information (as described above) is 
stored in the IRB, and no conditions or 
indications are cleared. Condition code 
1 is set to indicate that these actions 
have been taken. 

The figure "Conditions and Indications 
Cleared at the Subchannel by TEST 
SUBCHANNEL" describes which conditions 
and indications are 
SUBCHANNEL when the 
status-pending. All 
and indications at the 
unchanged. 



cleared by TEST 

subchannel is 

other conditions 

subchannel remain 
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Field 



Funct i on 
Control 



Act i vi ty 
Control 



Status 
Control 



N condi 
t i on 



Subchannel Condi tion* 



Alert 
Sta 
Pdg 



Cp 



Cs 



Int 
Sta 
Pdg 



Nc 



Nr 



Cs 



Nr 



Pri 
Sta 
Pdg 



Cp 



Cs 



Sec 
Sta 
Pdg 



Cp 



Cs 



Sta 

Pdg 

Alone 



Cp 



Cs 



Explanat i on ' 



Note that the rightmost column 
applies to status-pending when it 
is alone. The other four status- 
pending conditions result in the 
clearing actions given. These 
actions apply both when a single 
status-pending condition occurs 
and when a combination of the four 
status-pending conditions occurs. 
In the combination case* all the 
clearing actions of the individual 
cases apply. 
Cleared. 

The resume-, start", halt-, cleat — 
pending, and suspended conditions 
are cleared. 
Cs The status-pending condition is 
cleared. 

Not changed unless function con- 
trol indicates the halt function. 
If the halt function is indicated, 
conditions are cleared as for 
status-pending alone. 
Not changed unless function con- 
trol indicates either the halt 
function or the start function and 
activity control indicates resume- 
pending and suspended. If the 
halt function is indicated, the 
conditions sre cleared as for 
status-pending alone. If the 
start function is indicated and 
activity control indicates resume- 
pending and suspended, the resume- 
pending condition and the N condi- 
tion are cleared. 



C 
Cp 



Nc 



Nr 



Conditions and Indications Cleared 
at the Subchannel by TEST SUBCHANNEL 



Speci al Condi ti ons 



Condition code 3 is set and no other 
action is taken when the subchannel is 
not operational for TEST SUBCHANNEL. A 
subchannel is not operational for TEST 



SUBCHANNEL if 
provided, has 
assigned to it, 



the subchannel i s not 
no valid device number 
or is not enabled. 



TEST SUBCHANNEL can encounter the 
program exceptions listed below. When 
the execution of TEST SUBCHANNEL is 
terminated on addressing and protection 
exceptions, the state of the subchannel 
is not changed. Bit positions 0-15 of 
general register 1 must contain 0001 
hex; otherwise, an operand exception is 
recognized. The second operand must be 
designated on a word boundary; 
otherwise, a specification exception is 
recogni zed. 

Result i ng Condi ti on Code : 

IRB stored; subchannel status- 
pendi ng 

1 IRB stored; subchannel not 
status-pendi ng 

2 

3 Not operational 

Program Except i ons ? 

Access (store, operand 2) 

Operand 

Privileged operation 

Speci f i cati on 



Programmi ng Notes 



1. Device status that is stored in the 
SCSW may include device-busy, 
control-unit-busy, or control- 
unit-end indications. 

2. The information that is stored in 
the IRB is obtained from the 
subchannel. The TEST SUBCHANNEL 
instruction does not cause the 
channel subsystem to interrogate 
the addressed device. 

3. When an I/O interruption occurs, it 
is the result of a status- pendi ng 
condition at the subchannel, and 
typically TEST SUBCHANNEL is 
executed to clear the status. TEST 
SUBCHANNEL may also be executed at 
any other time to sample conditions 
existing at the subchannel. 
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selection the channel path with the 
IFCC condition, then the start 
function may not be initiated until 
the status-pending condition in the 
other subchannel is cleared, allow- 
ing the IFCC condition to be 
indicated at the subchannel to 
which it applies. 

Repeated execution of TEST SUBCHAN- 
NEL without an intervening delay, 
for example, to determine when a 
subchannel changes state, should be 
avoided because repeated accesses 
of the subchannel by the CPU tray 
delay or prohibit access of the 



subchannel by the channel subsystem 
in updating the subchannel. 

6. The priority of interruption handl- 
ing by a CPU can be modified by 
execution of TEST SUBCHANNEL. When 
TEST SUBCHANNEL is executed and the 
designated subchannel has an inter- 
ruption request pending, that 
interruption request is cleared and 
the SCSW is stored, without regard 
to any previously established 
priority. The relative priority of 
the remaining interruption requests 
i s unchanged. 
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Some I/O instructions specify to the 
channel subsystem that a function is to 
be performed. Collectively, these func- 
tions are referred to as the basic I/O 
functions. The basic I/O functions are 
the clear, halt, start, resume, and 
channel-path-reset functions. 



CONTROL OF BASIC I/O FUNCTIONS 



Information that is present at the 
subchannel controls how the clear, halt, 
resume, and start functions are 
performed. This information is communi- 
cated to the program in the subchannel- 
information block during execution of 
STORE SUBCHANNEL. 



SUBCHANNEL-INFORMATION BLOCK (SCHIB) 



The subchannel-information block (SCHIB) 
is the operand of the MODIFY SUBCHANNEL 
and STORE SUBCHANNEL instructions. The 
two rightmost bits of the SCHIB address 
are zeros, designating the SCHIB on a 
word boundary. The SCHIB contains three 
major fields: the path-management- 
control word (PMCW), the subchannel- 
status word (SCSW), and a model- 
dependent area. 

STORE SUBCHANNEL is used to store the 
current PMCW, the SCSW, and model- 
dependent data of the designated 
subchannel. MODIFY SUBCHANNEL alters 
certain PMCW fields at the subchannel. 
When the program needs to change the 
contents of one or more of the PMCW 
fields, the normal procedure is (1) to 
execute STORE SUBCHANNEL to obtain the 



current contents, (2) to perform the 
required modifications to the PMCW in 
main storage, and (3) to execute MODIFY 
SUBCHANNEL to pass the new information 
to the subchannel. The SCHIB has the 
following format: 



Word 






1 






2 
3 


P 


ath~Management-Control Word 


4 






5 






6 






7 






8 




Subchannel-Status Word 


9 






10 






11 




Model-Dependent Area 


12 







Path- Management -Control Word 



The path-management-control word (PMCW) 
has the format shown in the figure "PMCW 
Format" when the subchannel is valid 
(see the discussion of devi ce-numbei — 
valid bit later in this section). 



ord 



1 
2 
3 

5 
6 


Interrupt i on 


Parameter 






00 


ISC 


000 


E 


LM 


MM 


D 


r 


V 




Dev i ce 


Number 




LPM 


PNOM 


LPUM 


PIM 




MBI 


POM 


PAM 




CHPID-0 


CHPID-1 


CHPID-2 


CHPID-3 




CHPID-4 


CHPID-5 




CHPID-6 


CHPID-7 




00000000 00000000 


00000000 


00000000 



16 



31 



PMCW Format 
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Interrupt! on Pa rameter : Bits 0-31 of 
word contain the interruption parame- 
ter that i s stored as word 1 of the 
interruption code. The interruption 
parameter can be set to any value by 
START SUBCHANNEL and MODIFY SUBCHANNEL. 
The initial value of the interruption 
parameter is zero. 



Bits 
9 10 



I/Q-Int e rruptio n S ub 
2-4 of word 1 
r (0-7) which 
position of th 



Bits 
numbe 
bit 
subcl 
of ea 
sett i 
regi s 
ni ti o 
to th 
sect i 
Chapt 
ISC c 
SUBCH 
ISC i 



ass- mask bit in 
ch CPU in the 
ng of that mas 
ter 6 of a CPU 
n of interruptio 
i s subchannel by 
on "Pri ori ty of 
er 16, "I/O Int 
an be set to a 
ANNEL. The ini 
s zero. 



class C 

conta 

corresp 

e 1/0- 

contro 
conf i gu 
k bit 
control 
n reque 
that 

I n t e r r 
errupti 
ny valu 
tial v 



ode 
i n a 
onds 
inter 
1 reg 
rati o 

i n 
s the 
sts r 
CPU ( 
upti o 
ons") 
e by 
alue 



<J_SC> : 

bi nary 

to the 

rupt i on 

i ster 6 

n. The 

control 

recog- 

elat i ng 

see the 

ns" in 

The 

MODIFY 

of the 



Res erved : Bits 0~1 and 5-7 of word 1 
are reserved and stored as zeros by 
STORE SUBCHANNEL. They must be zeros 
when MODIFY SUBCHANNEL is executed; 
otherwise, an operand exception is 
recogni zed. 

Enab led (E): Bit R of word 1, when one, 
indicates that the subchannel is enabled 
for all I/O functions. When the E bit 
is zero, status presented by the device 
is not made available to the program, 
and I/O instructions other than MODIFY 
SUBCHANNEL and STORE SUBCHANNEL that are 
executed for the designated subchannel 
cause condition code 3 to be set. The E 
bit can be either zero or one when MODI- 
FY SUBCHANNEL is executed; initially, 
all subchannels are not enabled; IPL 
causes the IPL I/O device to become 
enabled. 



Limit Mode (LM): 
define the limit 
subchannel. The 1 
the channel subsyst 
check i ng is i nv 
operation. (See t 
Limit Check i ng" i 
Support Function 
checking is under 
address-limi t -check 
is passed to the 
operation-request b 
execution of START 
section "Operation- 
i n thi s chapter. ) 
these bits, whose v 
data transfer, ar^ 



Bits 9-10 o 
mode (LM) 
imi t mode i s 
em when addr 
oked for 
lie section 
n Chapter 
s.") Addr 
the contro 
i ng- control 

subchannel 
lock (ORB) d 
SUBCHANNEL. 
Request Bio 
The def i ni 
alues are us 
as follows: 



f w 
of 
us 

ess- 
an 

"Add 

17, 

GS5- 
1 Of 

bit 

i n 
uri n 
(Se 
ck" 
t i on 
ed d 



ord 1 

the 
ed by 
limit 

I/O 

ress- 

"1/0 

limit 

the 
that 

the 
g the 
e the 
later 
s of 
uri ng 



Functi on 

Initialized value. No limit 
checking is performed for this 
subchannel . 



Data address must 
or greater than, 
address limit. 



be equal to, 
the current 



1 



Data address must be less than 
the current address limit. 

Reserved. 



Bits 9 and 10 can contain any of the 
first three bit combinations shown above 
when MODIFY SUBCHANNEL is executed, 
of the reserved bit combi- 
operand causes an operand 
be recognized when MODIFY 
executed. 



Speci f i cat i on 
nation in the 
exception to 
SUBCHANNEL is 



Measurement Mode Enable (MM): Bits 11 
and 12 of word 1 enable the measure- 
ment-block-update mode and the device- 
connect-time-measurement mode, respec- 
tively, of the subchannel. These bits 
can contain any value when MODIFY 
SUBCHANNEL is executed; initially, 
neither measurement mode is enabled. 
The definition of each of these bits is 
as follows: 

Bit 11, Measurement-Block-Update Enable: 

Initialized value. The subchannel 
is not enabled for measurement- 
block update. Storing of 
measurement-block data does not 
occur. 



The 
measu 
measu 
act i v 
lated 
the t 
i s c 
subch 
condi 
logou 
measu 
i nact 
i s st 



subchannel 
rement-bloc 
rement-bloc 
e, measurem 
in the me 
i me channe 
ompleted or 
annel, pr 
tions descr 
t have been 
rement-bloc 
ive, no mea 
ored. 



i s enabled for 
k update. If the 
k-update mode i s 
ent data i s accumu- 
asurement block at 
1-program execution 

suspended at the 
ovided no error 
i bed by subchannel 

detected. If the 
k~update mode i s 
surement-block data 



Bit 12, 
Enable: 



Devi ce-Connect-Time-Measurement 



Initialized value. The subchannel 
is not enabled for devi ce-connect- 
time measurement. Storing of the 
devi ca-connect-t i me interval (DCTI) 
in the extended-status word (ESW) 
does not occur. 



The subchannel i s enabled for 
devi ce-connect-t ime measurement. 
If the devi ce-connect-t ime-measure- 
ment mode is active and timing 
facilities are provided for the 
subchannel, the value of the DCTI 
is stored in the ESW when TEST SUB- 
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CHANNEL is executed after channel- 
program execution is completed or 
suspended at the subchannel , pro- 
vided no error conditions described 
by subchannel logout have been 
detected. If the devi ce-connect- 
t i me-measurement mode is inactive, 
no measurement values are stored in 
the ESW. 



The meaning o 
enable bits d 
the timing-fa 
nel is one. 
bit is zero, 
is changed, 
"Timing Facil 
on measuremen 
"Measurement- 
Connecfc-T i me 
"I/O Support 



f the measurem 
escribed above 
ci 1 i ty bit for 
When the ti 
the effect of 
as described 
ity." (For mo 
t modes, see 
Block Update" 
Measurement" i 
Functi ons.") 



ent~mode 
appl i es 
the sub 

mi ng-fac 
the MM 
below 

re di scu 
the sec 
and "De 

n Chapte 



(MM) 
when 
chan- 
i 1 i ty 
bi ts 
under 
ssi on 
ti ons 
vi ce- 
r 17, 



Multipath Mode (D): Bit 13 of word 1, 
when one, indicates that the subchannel 
operates in multipath mode when execut- 
ing an I/O operation or chain of I/O 
operations. For proper operation in 
multipath mode when more than one chan- 
nel path is available for selection, the 
associated device must have the 
dynami c-reconnecti on feature installed 
and must be set up for mult i path-mode 
operation. During performance of a 
start function in multipath mode, a 
device is allowed to request service 
from the channel subsystem over any of 
the channel paths indicated at the 
subchannel as being available for 
selection (see the discussions of 
logical-path mask and path-available 
mask later in this section). Bit 13, 
when zero, indicates that the subchannel 
operates in single-path mode when 
executing an I/O operation or chain of 
I/O operations. In single-path mode, 
the entire start function is performed 
by using the channel path on which the 
first command of the I/O operation or 
chain of I/O operations was accepted by 
the device. The D bit can be either 
zero or one when MODIFY SUBCHANNEL is 
executed; initially the subchannel is in 
single-path mode. 



Timi ng F aci 1 i ty ( T ) : Bit 
when one, indicates that 
subsystem-timing facility 



14 of word 1 , 
the channel- 
is available 



for the subchannel and i s under the 
control of the two measurement-mode- 
enable bits (MM) and SET CHANNEL 
MONITOR. Bit 14, when zero, indicates 
that the channel-subsystem-timing facil- 
ity is not available for the subchannel. 
When bit 14 is zero, the START SUBCHAN- 
NEL count is the only measurement data 
that can be accumulated in the measure- 
ment block for the subchannel. Storing 
of the START SUBCHANNEL count is under 
the control of bit 11 and SET CHANNEL 
MONITOR, as described above under "Meas- 
urement Mode Enable." Similarly, if the 
T bit is zero, no devi ce~connect~t ime- 
interval (DCTI) values can be measured 
for the subchannel. (See the sections 



"Measurement-Block Update" and "Device- 
Connect-Time Measurement" in Chapter 17, 
"I/O Support Functions.") 

Devi ce Number Vali d (V): Bit 15 of word 
1, when one, indicates that the device- 
number field (see below) contains a 
valid device number and that a device 
associated with this subchannel may be 
physically installed. Bit 15 when zero 
indicates that the subchannel is not 
valid, there is no I/O device currently 
associated with the subchannel, and the 
contents of all other defined fields of 
the SCHIB are unpredictable. 



Devi ce Number : Bits 16-31 of word 1 
contain the binary representation of the 
four-digit hexadecimal device number of 
the device that is associated with this 
subchannel. The device number is 




Logical-Path Mask ( LPM) : Bits 0-7 of 
word 2 indicate the logical availability 
of channel paths to the associated 
device. Each bit of the LPM corresponds 
one-foi — one, by relative bit position, 
with a CHPID located in an associated 
byte of words 4 and 5 of the SCHIB. 
(Each CHPID contains an 8-bit value 
which uniquely identifies the physical 
channel path.) A bit set to one means 
that the corresponding channel path is 
logically available; a zero means the 
corresponding channel path is logically 
not available. When a channel path is 
logically not available, the channel 
subsystem does not use that channel path 
to initiate performance of any clear, 
halt, resume, or start function, except 
when a dedicated allegiance exists for 
that channel path. When a dedicated 
allegiance exists at the subchannel for 
a channel path, the logical availability 
of the channel path is ignored whenever 
a clear, halt, resume, or start function 
is performed. (See the section 
"Channel-Path Allegiance" later in this 
chapter). If the subchannel is idle, 
the logical availability of the channel 
path is ignored whenever the control 
unit initiates a request to present 
alert status to the channel subsystem. 
The logical availability of a channel 
path associated with the subchannel can 
be changed by setting the corresponding 
LPM bit in the SCHIB and then executing 
MODIFY SUBCHANNEL, or by setting the 
corresponding LPM bit in 
then executing START 
Initially, each installed 
is logically available. 



the ORB and 

SUBCHANNEL. 

channel path 



P ath-Not-Qperati onal Mask (PNOM): Any 
of bits 8-15 of word 2, when one, indi- 
cates that a path-not-operational condi- 
tion has been recognized on the 
corresponding channel path. Each bit of 
the PNOM corresponds one-for-one, by 
relative bit position, with a CHPID 
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byte of words 4 
(Each CHPID 

which uniquely 
channel path.) 

recognizes a 



located in an associated 
and 5 of the SCHIB. 
contains an 8-bit value 
identifies the physical 
The channel subsystem 
path-not-operational condition when, 
during an attempted device selection in 
order to perform a clear, halt, resume, 
or start function, the device associated 
with the subchannel appears not opera- 
tional on a channel path that is 
operational for the subchannel. When a 
path-not-operational condition is recog- 
nized, the state of the channel path 
changes from operational for the 
subchannel to not operational for the 
subchannel. A channel path is opera- 
tional for the subchannel if the 
associated device appeared operational 
on that channel path the last time the 
channel subsystem attempted device 
selection in order to perform a clear, 
halt, resume, or start function. A 
device appears to be operational on a 
channel path when the device responds to 
an attempted device selection. A chan- 
nel path is not operational for the 
subchannel if the associated device 
appeared not operational on that channel 
path the last time the channel subsystem 
attempted device selection in order to 
perform a clear, halt, resume, or start 
function. Any of bits 8-15 of word 2, 
when zero, indicates that a path-not- 
operational condition has not been 
recognized on the corresponding channel 
path. 



Initially, each of 
channel paths as 
subchannel are con 
tional, regardles 
respective channel 
or available; there 
not-operational con 
during initial pr 
PMCW, if stored, co 
zeros if stored p 
CLEAR SUBCHANNEL, 



the eight possible 
sociated with each 
sidered to be opera- 
s of whether the 
paths are installed 
fore, unless a path- 
dition is recognized 
ogram loading, the 
ntains a PNOM of all 
rior to executing a 
HALT SUBCHANNEL, 



RESUME SUBCHANNEL, or START SUBCHANNEL 
instructi on. 



Programming Note 



The PNOM indicates those channel paths 
for which a path-not-operational condi- 
tion has been recognized during the 
performance of the most recent clear, 
halt, resume, or start function. That 
is, the PNOM indicates which of the 
channel paths associated with the 
made a transition from 
to the not-operational 
subchannel during the 
the most recent clear, 
start function. Howev- 
er, the transition of a channel path 
from the not-operational to the opera- 
tional state for the subchannel is 
indicated in the POM. Therefore, the 
POM must be examined in order to detei — 
mine whether any of the channel paths 
that are associated with a designated 
subchannel are operational for the 
subchannel . 



subchannel have 
the operational 
state for the 
performance of 
halt, resume, or 



Furthermore, while performing either a 
start or resume function, the transition 
of a channel path from the not- 
operational to the operational state for 
the subchannel is recognized by the 
channel subsystem only during the initi- 
ation sequence for the first command 
specified by the start function or 
implied by the resume function. There- 
fore, a channel path which is currently 
not operational for the subchannel can 
be used by the device associated with 
the subchannel when reconnecting to the 
channel subsystem in order to continue 
command chaining; however, the channel 

indicate a transition 
path from the not- 
operational state for 
the POM. 



subsystem does not 
of that channel 
operational to the 
the subchannel in 
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POM Value and 
Device State 
Before Select- 
ion Attempt 



Device 
State 1 



OP 
NOP 
OP 
NOP 



POM 



Value of Specified 
Bit Subsequent to 
Selection Attempt 



POM 



PNOM" 



SCSW 
N bit 






l 3 



Ex planati on 



1 Device state as it appears on 
the corresponding channel path. 

2 Prior to the attempted device 
selection during the performance 
of either a start function or 

a resume function while the 
subchannel is suspended, the 
channel subsystem clears all 
existing path-not-operational 
conditions, if any, at the des- 
ignated subchannel. 

3 The N bit (bit 15, word of the 
SCSW) is indicated to the pro- 
gram and the N condition is 
cleared at the subchannel when 
TEST SUBCHANNEL is executed the 
next time the subchannel is 
status-pending for other than 
intermediate status alone pro- 
vided that it is not also sus- 
pended. 

NOP The device is not operational on 
the corresponding channel path. 



OP The device is operational on 
corresponding channel path. 



the 



Resulting POM, PNOM, and N-bit Values 
Subsequent to Selection Attempt 



Last-Path-Used Mask ( LPUM ): Bits 16-23 
of word 2 indicate the channel path that 
was last used for communicating or 
transferring information between the 
channel subsystem and the device. Each 
bit of the LPUM corresponds one-for-one, 
by relative bit position, with a CHPID 
located in an associated byte of words 4 
and 5 of the SCHIB. (Each CHPID 
contains an 8-bit value which uniquely 
identifies the physical channel path.) 
Each bit of the LPUM is stored as zero 
except for the bit which corresponds to 
the channel path last used whenever one 
of the following occurs: 

1. The first command of a start or 
resume function is accepted by the 
device (see the section "Activity 
Control" in Chapter 16, "I/O Inter- 
rupti ons") . 



2. The device and channel subsystem 
are actively communicating when the 
suspend function is performed for 
the channel program in execution. 

3. Status has been accepted from the 
device that is recognized as an 
interruption condition, or a condi- 
tion has been recognized that 
suppresses command chaining (see 
the section "Interruption Condi- 
tions" in Chapter 16, "I/O 
Interruptions") . 

4. An interface-control-check condi- 
tion has been recognized (see the 
section "Interface-Control Check" 
in Chapter 16, "I/O Interrup- 
tions"), and no subchannel-logout 
information is currently present in 
the subchannel. 

The LPUM field of the PMCW contains the 
most recent setting. The initial value 
of the LPUM is zero. 

Path-Installed Mask (PIM)t Bits 24-31 
of word 2 indicate which of the channel 
paths 0-7 to the I/O device are phys- 
ically installed. The PIM indicates the 
validity of the channel-path identifiers 
(see below) for those channel paths that 
are physically installed. Each bit of 
the PIM corresponds one-foi — one, by 
relative bit position, with a CHPID 
located in an associated byte of words 4 
and 5 of the SCHIB. (Each CHPID 
contains a value which uniquely identi- 
fies the physical channel path.) A PIM 
bit stored as one indicates that the 
corresponding channel path is installed. 
A PIM bit stored as zero indicates that 
the corresponding channel path is not 
installed. The PIM always reflects the 
full complement of installed paths to 
the device, regardless of how the system 
is configured. Therefore, some of the 
channel paths indicated in the PIM may 
not be physically available in that 
configuration, as indicated by the bit 
settings in the path-available mask (see 
below). The initial value of the PIM 
indicates all the physically installed 
channel paths to the device. 

Measurement-Block Index ( MB I ) : Bits 
0-15 of word 3 form an index value used 
by the measurement-block-update facility 
when the measurement-block-update mode 
is active (see the section "SET CHANNEL 
MONITOR" in Chapter 14, "I/O 
Instructions") and the subchannel is 
enabled for the mode (see the discussion 
of the measurement-mode-enable bits, 
bits 11-12, earlier in this section). 
When the measurement-block index is 
used, five zero bits are appended on the 
right, and the result is added to the 
measurement-block-origin address desig- 
nated by SET CHANNEL MONITOR. The 
calculated address, called the 
measurement-block address, designates 
the beginning of a 32-byte storage area 
where 16 bytes of measurement data are 
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stored (see the section "Measurement 
Block" in Chapter 17, "I/O Support Func- 
tions"). The MBI can contain any value 
when MODIFY SUBCHANNEL is executed; the 
initial value is zero. 

Path-Operational Mask (POM): Bits 16-23 
of word 3 indicate the last known opera- 
tional state of the device on the corre- 
sponding channel paths. Each bit of the 
POM corresponds one-foi — one, by relative 
bit position, with a CHPID located in an 
associated byte of words 4 and 5 of the 
SCHIB. (Each CHPID contains an 8-bit 
value which uniquely identifies the 
physical channel path.) If the associ- 
ated device appeared operational on a 
channel path the last time the channel 
subsystem attempted device selection in 
order to perform a clear, halt, resume, 
or start function, then the channel path 
is operational for the subchannel, and 
the bit corresponding to the channel 
path in the POM is one. A device 
appears to be operational on a channel 
path when the device responds to an 
attempted device selection. A channel 
path is also operational for the 
subchannel if MODIFY SUBCHANNEL is 
executed and the bit corresponding to 
that channel path in the POM is speci- 
fied as one. 
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be operational again on that channel 
path, then the state of the channel path 
changes from not operational for the 
subchannel to operational for the 
subchannel . 

The POM can contain any value when MODI- 
FY SUBCHANNEL is executed. Initially, 
each of the eight possible channel paths 
associated with each subchannel are 
considered to be operational, regardless 
of whether the respective channel paths 
are installed or available; therefore, 
unless a path-not-operational condition 
is recognized during initial program 
loading, the PMCW, if stored, contains a 
POM of all ones if stored prior to 
executing a CLEAR SUBCHANNEL, HALT 
SUBCHANNEL, RESUME SUBCHANNEL, or START 
SUBCHANNEL instruction. 

Path-Available Mask (PAM): Bits 24-31 
of word 3 indicate the physical avail- 
ability of installed channel paths. 
Each bit of the PAM corresponds one- 
for-one, by relative bit position, with 
a CHPID located in an associated byte of 
words 4 and 5 of the SCHIB. (Each CHPID 
contains an 8-bit value which uniquely 
identifies the physical channel path.) 
A PAM bit of one indicates that the 
corresponding channel path is physically 
available for use in accessing the 
device. A PAM bit of zero indicates the 
channel path is not physically available 
for use in accessing the device. When a 
channel path is not physically 
available, it may, depending upon the 
model and the extent of failure, be used 
during performance of the reset- 
channel-path function. A channel path 
which is physically available may become 
not physically available as a result of 
reconfiguring the system, or this may 
occur as a result of the performance of 
the channel-path-reset function. 



If the device associated with the 
subchannel appears not operational on a 
channel path that is operational for the 
subchannel during an attempted device 
selection in order to perform a clear, 
halt, resume, or start function, then 
the channel subsystem recognizes a 
path-not-operational condition. If an 
5CSW is subsequently stored, then bit 15 
of word 1 is one, indicating the path- 
not-operational condition. When a 
path-not-operational condition is recog- 
nized, the state of the channel path 
changes from operational for the 
subchannel to not operational for the 
subchannel . 

When the channel path is not operational 
for the subchannel, a path-not- 
operational condition cannot be recog- 
nized. Moreover, a channel path that is 
not operational for the subchannel may 
be available for selection; if the chan- 
nel subsystem chooses that channel path 
while executing a path-management opera- 
tion, and if during the the attempted 
device selection, the device appears to 



The initial 
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Note: The change in the availability of 
a channel path affects all subchannels 
having access to that channel path. 
Whenever the setting of a PAM bit is 
referred to in conjunction with the 
availability status of a channel path, 
for brevity, reference is made in this 
chapter to a single PAM bit instead of 
to the respective PAM bits in all of the 
affected subchannels. 
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Identifiers (CJHPIDs): 
5 contain eight one-byte 
identifiers corresponding 
paths 0-7 of the PIM. A 
id if the corresponding PIM 
Each valid CHPID contains 
ier of a physical channel 
control unit by which the 
/0 device may be accessed. 
ID is assigned to each phys- 
path in the system. 
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Different devices that are accessible by 
the same physical channel path have, in 
their respective subchannels, the same 
CHPID value. The CHPID value may, 
however, appear in each subchannel in 
different locations in the CHPID fields 
0-7. 

Subchannels that share an identical set 
of channel paths have the same corre- 
sponding PIM bits set to ones. The 
channel-path identifiers (CHPIDs) for 
these channel paths are the same and 
occupy the same respective locations in 
each SCHIB. 

Reserved : Word 6 of the SCHIB is 
reserved and is stored as zero by STORE 
SUBCHANNEL. Bits 0-31 of word 6 of the 
SCHIB operand must be zeros, when MODIFY 
SUBCHANNEL is executed; otherwise, an 
operand exception is recognized. 



Subchannel -Status Word 



Words 7-9 contain a copy of the SCSW. 
The format of the SCSW is described in 
the section "Subchannel-Status Word" in 
Chapter 16, "I/O Interruptions." The 
SCSW is stored by executing either STORE 
SUBCHANNEL or TEST SUBCHANNEL (see Chap- 
ter 14, "I/O Instructions"). 



Model- Dependent Area 



Words 10-12 contain model-dependent 
informati on. 



Summary of Modi f iable Fields 



The figure "Modification of Subchannel 
Fields" lists the initial settings for 
fields in a subchannel whose device- 
numbei — valid bit is set to one, and 
indicates what modifies the fields. 

All of the PMCW fields contain meaning- 
ful information when STORE SUBCHANNEL is 
executed and the designated subchannel 
is idle. Subchannel fields that the 
channel subsystem does not modify 
contain valid information whenever STORE 
SUBCHANNEL is executed, provided that 
the devi ce-numbei — valid bit is one. The 
validity of the subchannel fields that 
are modifiable by the channel subsystem 
depends on the state of the subchannel 
at the time STORE SUBCHANNEL is 
executed. 
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Subchannel Field 


Initial 
Volue 1 


Program 
Modi f i es 

by 
Executi ng 


Modi f i ed 
by 
Channel 
Subsystem 2 


Interruption parameter 


Zeros 


MSCH,SSCH 


No 


I/O-i nterrupti on subclass 
code 


Zeros 


MSCH 


No 


Enabled 


Zero 


MSCH 


No 


Limit mode 


Zeros 


MSCH 


No 


Measurement mode 


Zeros 


MSCH 


Yes 3 


Multipath mode 


Zero 


MSCH 


No 


Timing faci li ty 


Installed 
value 4 


None 


No 


Device number valid 


Installed 
value* 


None 


No 


Device number 


Installed 
value 4 


None 


No 


Logical-path mask 


Equal to 

path- 

i nstalled- 

mask value 


MSCH,SSCH 


No 


Path-not-operati onal 
mask 


Zeros 


CSCH,SSCH, 
RSCH 5 


Yes 


Last-path-used mask 


Zeros 


CSCH 


Yes 


Path-installed mask 


Installed 
value 4 


None 


No 


Measurement-block index 


Zeros 


MSCH 


No 


Path-operational mask 


Ones 


CSCH, MSCH 
RSCH 5 


Yes 


Path-available mask 


Installed 
values 4 6 


None 


Yes 6 


Channel-path ID 0-7 


Installed 
value 4 


None 


No 


Subchannel-status word 


Zeros 


TSCH 


Yes 


Model-dependent area 


X 


None 


X 



Modification of Subchannel Fields (Part 1 of 2) 
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Explanation 



Model -dependent 



These fields 
not valid, 
formed when 
section "I/O 
Support Func 
value parame 
gram may be 
this case, a 
set to their 
notified of 
(See the sec 
Chapter 17, 



are not meaningful if the subchannel is 
Initializing of a subchannel is per- 
I/O-system reset occurs. (See the 
-System Reset" in Chapter 17, "I/O 
tions.") One or more of the installed- 
ters that are unmodifiable by the pro- 
set when the subchannel is idle. In 
11 the program-modifiable fields are 

initialized values, and the program is 
such a change by a channel report, 
tion "Channel-Report Word" in 
"I/O Support Functions.") 



Subchannel fields that are not normally modifiable 
by the channel subsystem may be modified by exter- 
nal means. When this occurs, the program is noti- 
fied of the change by a channel report that is made 
pending at the time of the change. 

When any of the following error conditions assoc- 
iated with the measurement-block-update mode are 
detected, the measurement-block-update mode is dis- 
abled by the channel subsystem (bit 11, word 1, of 
the SCHIB zero) in the affected subchannel. The 
devi ce-connect-time-measurement-enable bi t 
(bit 12, word 1 of the SCHIB) is never modified by 
the channel subsystem. 

Measurement program check 
Measurement protection check 
Measurement data check 
Measurement key check 

This information is entered when the channel- 
subsystem configuration is established. 



The mask is modified 
the subchannel is in 
RESUME SUBCHANNEL is 



by the resume 
the suspended 
executed. 



function 
state at 



only when 
the time 



The channel subsystem may modify the PAM to reflect 
changes in the system configuration caused by pai — 
titioning or unparti ti oni ng channel paths because of 
reconfiguration or permanent failure of part of the 
I/O system. 



Modification of Subchannel Fields (Part 2 of 2) 



Programmi ng Notes 



System performance may be degraded 
if the LPM is not used to make 
channel paths for which a path- 
not-operational condition has been 
indicated in the PNOM logically not 
avai lable. 
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start func 
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perform- 

may be 

program 
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i n the 



subchannel-and-devi ce-act i ve state 
until cleared by the performance of 
the clear function. 

If the same MBI is placed in more 
than one subchannel by the program, 
the channel-subsystem-moni tori ng 
facility updates the same locations 
with measurement data relating to 
more than one subchannel. In this 
case, the values stored in the 
measurement data are unpredictable. 
(See the section "Measurement-Block 
Update" in Chapter 17, "I/O Support 
Functions.") 

Modification of the I/O configura- 
tion (reconfiguration) may be 
accomplished in various ways 
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5. 



6. 



depending on the model. If the 
reconfiguration procedure affects 
the physical availability of a 
channel path* then any change in 
availability can be detected by 
executing STORE SUBCHANNEL for a 
subchannel that has access to the 
channel path and by subsequently 
examining the PAM bits of the 
SCHIB. 

The definitions of the PNOM, POM, 
and N bit are such that a path- 
not-operational condition is 
reported to the program only the 
first time the condition is 
detected by the channel subsystem 
after the corresponding POM bit is 
set to one. 

For example, if the POM bit for 
every channel path available for 
selection is one and the device 
appears not operational on all 
corresponding channel paths while 
the channel subsystem is attempting 
to initiate a start function at the 
device, the channel subsystem makes 
the subchannel status-pending, with 
deferred condition code 3 and with 
the N bit stored as one. The PNOM 
in the SCHIB indicates the channel 
path or channel paths that appeared 
not operational, for which the 
corresponding POM bits have been 
set to zeros. The next START 
SUBCHANNEL causes the channel 
subsystem to again attempt device 
selection by choosing a channel 
path from among all of the channel 
paths that are available for 
selection. If device selection is 
not successful and all channel 
paths available for selection have 
again been chosen, deferred condi- 
tion code 3 is set, but the N bit 
in the SCSW is zero. The POM 
contains zeros in at least those 
bit positions that correspond to 
the channel paths that are avail- 
able for selection. (See the 
section "Channel-Path Availability" 
later in this chapter for a 
description of the term "available 
for selection.") When the N bit in 
the SCSW is zero, the PNOM is also 
zero. 
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CHANNEL-PATH ALLEGIANCE 



The channel subsystem establishes alle- 
giance conditions between subchannels 
and channel paths. The kind of alle- 
giance established at a subchannel for a 
channel path or set of channel paths 
depends upon the state of the 
subchannel, the device, and the informa- 
tion, if any, transferred between the 
channel subsystem and device. The way 
in which path management is handled 
during the performance of a clear, halt, 
resume, or start function is determined 
by the kind of allegiance, if any, 
currently recognized between a subchan- 
nel and a channel path. 

Performing the clear function at a 
subchannel clears any currently existing 
allegiance condition in the subchannel 
for all channel paths. 

Performing the reset-channel-path func- 
tion clears all currently existing alle- 
giances for that channel path in all 
subchannels. 

When a channel path becomes not phys- 
ically available, all internal indi- 
cations of prior allegiance conditions 
are cleared in all subchannels having 
access to the designated channel path. 



WORKING ALLEGIANCE 



A subchannel has a working allegiance 
for a channel path when the subchannel 
becomes device-active on that channel 
path. Once a working allegiance is 
established, the channel subsystem main- 
tains the working allegiance at the 
subchannel for the channel path until 
either the subchannel is no longer 
device-active or a dedicated allegiance 
is recognized, whichever occurs earlier. 
Unless a dedicated allegiance is recog- 
nized, a working allegiance for a 
channel path i s extended to the set of 
channel paths that are available for 
selection if the device is specified to 
be operating in multipath mode (that is, 
the multi path-mode bit is stored as one 
in the SCHIB). Otherwise, the working 
allegiance remains only for that channel 
path over which the start function was 
i ni tiated. 

Once a working allegiance is established 
for a channel path or set of channel 
paths, the working allegiance is not 
changed until the subchannel is no long- 
er device-active or until a dedicated 
allegiance is established. If the 
subchannel is operating in single-path 
mode, a working allegiance is maintained 
only for a single path. 

While a working allegiance exists at a 
subchannel, an active allegiance can 



Chapter 15. Basic I/O Functions 15-11 



occur only for a channel path for which 
the working allegiance is be : ng main- 
tained! unless the device is specified 
as operating in multipath mode. When 
the device is specified as operating in 
multipath mode/ an active allegiance may 
also occur for a channel path that is 
not available for selection if the pres- 
entation of status by the device on that 
channel path causes an alert intei — 
ruption condition to be recognized. 

A working allegiance is cleared in any 
subchannel having access to a channel 
path if the channel path becomes not 
physically available. 



ACTIVE ALLEGIANCE 



A subchannel has an active allegiance 
established for a channel path no later 
than when active communication has been 
initiated on that channel path with an 
I/O device. The subchannel can have an 
active allegiance to only one channel 
path at a time. While the subchannel 
has an active allegiance for a channel 
path, the channel subsystem does not 
actively communicate with that device on 
any other channel path. When the chan- 
nel subsystem accepts a no-longei — busy 
indication from the device that does not 
cause an interruption condition* this 
status does not constitute the initi- 
ation of active communication. An 
active allegiance at a subchannel for a 
channel path is terminated when the 
channel subsystem is no longer actively 
communicating with the I/O device on 
that channel path. 

A working allegiance can become an 
active allegiance. 



DEDICATED ALLEGIANCE 



If a channel path is physically avail- 
able (that is, the corresponding PAM bit 
is one), a dedicated allegiance may be 
recognized for that channel path. If a 
channel path is not physically 
available, a dedicated allegiance cannot 
be recognized for the corresponding 
channel path. The channel subsystem 
establishes a dedicated allegiance at 
the subchannel for a channel path when 
the subchannel becomes status-pending 
with alert status, and device status 
containing the unit-check indication is 
present at the subchannel. A dedicated 
allegiance is maintained until the 
subchannel is no longer start-pending 
(unless it becomes suspended) or 
resume-pending following performance of 
the next start function, clear function, 
or channel-path-reset function or the 
next resume function if applicable. If 
the subchannel becomes suspended, the 



dedicated allegiance remains until the 
resume function is initiated and the 
subchannel is no longer resume-pending. 
Unless a clear or channel-path-reset 
function is performed, the subchannel 
establishes a working allegiance when 
the dedicated allegiance ends. This 
occurs when the subchannel becomes 
device-active. While a dedicated alle- 
giance exists at a subchannel, only that 
channel path is available for selection 
until the dedicated-allegiance condition 
is cleared. 

A dedicated allegiance can become an 
active allegiance. While a dedicated 
allegiance exists, an active allegiance 
can only occur for the same channel 
path. 

A currently existing dedicated alle- 
giance is cleared at any subchannel 
having access to a channel path when the 
channel path becomes not physically 
available or whenever the device appears 
not operational on the channel path for 
which the dedicated allegiance exists. 



CHANNEL-PATH AVAILABILITY 



When a channel path is not physically 
available, the channel subsystem does 
not use the channel path to perform any 
of the basic I/O functions except, in 
some cases, the channel-path-reset func- 
tion and does not respond to any 
control-unit-initiated requests on that 
same channel path. If a channel path is 
not physically available, the condition 
is indicated by the corresponding path- 
available-mask (PAM) bit being zero when 
STORE SUBCHANNEL is executed (see the 
description of the PAM in the section 
"Path-Management-Control Word" earlier 
in this chapter). Furthermore, if the 
channel path is not physically available 
for the subchannel designated by STORE 
SUBCHANNEL, then it i s not physically 
available for any subchannel that has a 
device which is accessible by that chan- 
nel path. 

Unless a dedicated allegiance exists at 
a subchannel for the channel path, a 
channel path becomes available for 
selection if it is logically available 
and physically available (as indicated 
by the bits in the LPM and PAM corre- 
sponding to the channel path being 
stored as ones when STORE SUBCHANNEL is 
executed). If a dedicated allegiance 
exists at a subchannel for the channel 
path, only that channel path is avail- 
able for selection, and the setting of 
the corresponding LPM bit is ignored. 
If the channel path is currently being 
used and a dedicated allegiance exists 
at the subchannel for the channel path, 
selection of the device is delayed until 
the channel path is no longer being 
used. 
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The availability status of the eight 
logical paths to the associated device 
described in the figure "Path Condition 
and Path-Availability Status for PIM, 
PAM, and LPM Values" is determined by 
the hierarchical arrangement of the 
corresponding bit values contained in 
the PIM, PAM, and LPM and by existing 
conditions, if any# recognized by the 
channel subsystem. 



CONTROL-UNIT TYPE 



Value of 
Bit "n" 



PIM 



PAM 



LPM 



Channel- 
Path 
Condi tion 1 



Active 



Inacti ve 



Channel-Path 
State 



Not installed 



Not physically 
avai lable 



Not logically 
avai lable 



Available for 
selecti on 4 



Available for 
selecti on 



Explanat i on : 



- Bit value is not meaningful. 

1 If the channel path is recognized 
as being used in active communi- 
cation with a device, the channel- 
path condition is described as 
active. If the channel path is 
recognized as not being used in 
active communication, the condition 
is described as inactive. 

2 A PAM bit cannot have the value one 
when the corresponding PIM bit has 
the value zero. 

3 If a dedicated allegiance exists to 
the channel path at the subchannel, 
the state of the bit is ignored, 
and the channel path is considered 
to be available for selection. 

4 The channel path may appear to be 
active when a channel-path-terminal 
condition has been recognized. 

X Condition is not meaningful. 



Path Condition and Path-Availability 
Status for PIM, PAM, and LPM Values 



In the sections 
Function," and 
Resume Function" 
i s made to type 
control units, 
these control-uni 
Library publicati 
System/370 I/O 
Control Unit OEMI 



CLEAR FUNCTION 



Subsequent to the execut 
SUBCHANNEL, the chann 
performs the clear functi 
ance of the clear functi o 
(1) executing a path-mana 
tion, (2) modifying fie 
subchannel, (3) issuing th 
to the associated 
(4) causing the subchanne 
status-pending, indicating 
the clear function. 



"Clear Function," "Halt 
"Start Function and 
that follow, reference 
1, type 2, and type 3 
For a description of 
t types, see the System 
on IBM System/360 and 
Interface Channel to 
, GA22-6974. 
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CLEAR-FUNCTION PATH MANAGEMENT 



A path-management operation is executed 
as part of the clear function in order 
to examine channel-path conditions for 
the associated subchannel and to attempt 
to choose an available channel path on 
which the clear signal can be issued to 
the associated device. 



Channel-path conditions are 
the following order: 



examined in 



1. If the channel subsystem is active- 
ly communicating or attempting to 
establish active communication with 
the device to be signaled, the 
channel path that is in use is 
chosen. 

2. If the channel subsystem is in the 
process of accepting a no-longer- 
busy indication (which will not 
cause an interruption condition to 
be recognized) from the device to 
be signaled, and the associated 
subchannel has no allegiance to any 
channel path, the channel path that 
is in use is chosen. 

3. If the associated subchannel has a 
dedicated allegiance for a channel 
path, that channel path is chosen. 

4. If the associated subchannel has a 
working allegiance for one or more 
channel paths, one of those channel 
paths is chosen. ■,•• 

5. If the associated subchannel has no 
allegiance for any channel path, if 
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a last-used channel path is indi- 
cated, and if that channel path is 
available for selection, that chan- 
nel path is chosen. If that channel 
path is not available for 
selection, either no channel path 
is chosen or a channel path is 
chosen from the set of channel 
paths, if any, that are available 
for selection (as though no last- 
used channel path were indicated). 

6. If the associated subchannel has no 
allegiance for any channel path, if 
no last-used channel path is indi- 
cated, and if there exist one or 
more channel paths that are avail- 
able for selection, one of those 
channel paths is chosen. 

If none of the channel-path conditions 
listed above apply, no channel path is 
chosen . 

For item 4, for item 5 under the speci- 
fied conditions, and for item 6 above, 
the channel subsystem chooses a channel 
path from a set of channel paths. In 
these cases the channel subsystem may 
attempt to choose a channel path, 
provided that the following conditions 
do not apply: 

1. A channel-path-terminal condition 
exists for the channel path. 

2. Another subchannel has an active 
allegiance for the channel path. 

3. The device to be signaled is 
attached to a type-1 control unit, 
and the subchannel for another 
device attached to the same control 
unit has an allegiance to the same 
channel path, unless the allegiance 
is a working allegiance and primary 
status has been accepted by that 
subchannel . 

4. The device to be signaled is 
attached to a type-3 control unit, 
and the subchannel for another 
device attached to the same control 
unit has a dedicated allegiance to 
the same channel path. 



CLEAR-FUNCTION SUBCHANNEL MODIFICATION 



Path-management-control indications at 
the subchannel are modified during 
performance of the clear function. 
Effectively, this modification occurs 
after the attempt to choose a channel 
path, but prior to the attempt to select 
the device to issue the clear signal. 
The path-management-control indications 
that are modified are as follows: 

1. The state of all eight possible 
channel paths at the subchannel i s 



set to operational for the subchan- 
nel . 

2. The last-path-used indication is 
reset to indicate no last-used 
channel path. 

3. Path-not-operational conditions, if 
any, are reset. 



CLEAR-FUNCTION SIGNALING AND COMPLETION 



Subsequent to the attempt to choose a 
channel path and the modification of the 
path-management-control fields, the 
channel subsystem, if conditions allow, 
attempts to select the device to issue 
the clear signal. (See the section 
"Clear Signal" in Chapter 17, "I/O 
Support Functions.") Conditions associ- 
ated with the subchannel and the chosen 
channel path, if &ny f affect (1) whether 
an attempt is made to issue the clear 
signal, and (2) whether the attempt to 
issue the clear signal is successful. 
Independent of these conditions, the 
subchannel is subsequently set status- 
pending and the performance of the clear 
function is complete. These conditions 
and their effect on the clear function 
are described as follows: 

No Attempt Is Made to Issue the Clear 
Si gnal : The channel subsystem does not 
attempt to issue the clear signal to the 
device if any of the following condi- 
tions exist: 

1. No channel path was chosen. (See 
the section "Clear-Function Path 
Management" earlier in this 
chapter. ) 

2. The chosen channel path is no long- 
er available for selection. 

3. A channel-path-terminal condition 
exists for the chosen channel path. 

4. The chosen channel path is current- 
ly being used to actively communi- 
cate with a different device. 

5. The device to be signaled is 
attached to a type-1 control unit, 
and the subchannel for another 
device attached to the same control 
unit has an allegiance to the same 
channel path, unless the allegiance 
is a working allegiance and primary 
status has been accepted by that 
subchannel . 

6. The device to be signaled is 
attached to a type-3 control unit, 
and the subchannel for another 
device attached to the same control 
unit has a dedicated allegiance to 
the same channel path. 
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If any of the conditions above exist, 
the subchannel remains clear-pending and 
is set status-pending* and the perform- 
ance of the clear function is complete. 

The Attempt to Issue the Clear Si gnal Is 
Not Successful : When the channel 
subsystem attempts to issue the clear 
signal to the device, the attempt may 
not be successful because of the follow- 
ing conditions: 

1. The control unit or device signals 
a busy condition when the channel 
subsystem attempts to select the 
device to issue the clear signal. 

2. A path-not-operational condition is 
recognized when the channel subsys- 
tem attempts to select the device 
to issue the clear signal. 

3. An error condition is encountered 
when the channel subsystem attempts 
to issue the clear signal. 

If any of the conditions above 
exist and the channel subsystem 
either determines that the attempt 
to issue the clear signal was not 
successful or cannot determine 
whether the attempt was successful, 
the subchannel remains cleai — 
pending and is set status-pending, 
and the performance of the clear 
function is complete. 
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Subsequent to the performance of the 
clear function, any nonzero status, 
except control-unit end alone, that is 
presented to the channel subsystem by 
the device is passed to the program as 
unsolicited alert status. Unsolicited 
status consisting of control-unit end 
alone or zero status is not presented to 
the program. 



HALT FUNCTION 



Subsequent to the execution of HALT 
SUBCHANNEL, the channel subsystem 
performs the halt function. Performance 
of the halt function consists in 



(1) executing a path-management oper- 
ation, (2) issuing the halt signal to 
the associated device, and (3) causing 
the subchannel to be made status- 
pending, indicating completion of the 
halt function. 



HALT-FUNCTION PATH MANAGEMENT 



A path-management operation is executed 
as part of the halt function to examine 
channel-path conditions for the associ- 
ated subchannel and to attempt to choose 
a channel path on which the halt signal 
can be issued to the associated device. 



Channel-path conditions are 
the following orders 



examined in 



1. If the channel subsystem is active- 
ly communicating or attempting to 
establish active communication with 
the device to be signaled, the 
channel path that is in use is 
chosen. 

2. If the channel subsystem is in the 
process of accepting a no-longei — 
busy indication (which will not 
cause an interruption condition to 
be recognized) from the device to 
be signaled, and the associated 
subchannel has no allegiance to any 
channel path, the channel path that 
is in use is chosen. 

3. If the associated subchannel has a 
dedicated allegiance for a channel 
path, that channel path is chosen. 

4. If the associated subchannel has a 
working allegiance for one or more 
channel paths, one of those channel 
paths is chosen. 



5. 



6. 
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If the associated subchannel has no 
allegiance for any channel path, if 
no last-used channel path is indi- 
cated, and if there exist one or 
more channel paths that are avail- 
able for selection, one of those 
channel paths is chosen. 



If none of the channel-path conditions 
listed above apply, no channel path is 
chosen. 
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For item 4, for item 5 under the speci- 
fied conditions, and for item 6 above, 
the channel subsystem chooses a channel 
path from a set of channel paths. In 
these cases the channel subsystem may 
attempt to choose a channel path for 
which the following conditions do not 
apply: 

1. A channel-path-terminal condition 
exists for the channel path. 

2. Another subchannel has an active 
allegiance for the channel path. 

3. The device to be signaled is 
attached to a type-1 control unit, 
and the subchannel for another 
device attached to the same control 
unit has an allegiance to the same 
channel path, unless the allegiance 
is a working allegiance and primary 
status has been accepted by that 
subchannel . 

4. The device to be signaled is 
attached to a type-3 control unit, 
and the subchannel for another 
device attached to the same control 
unit has a dedicated allegiance to 
the same channel path. 



HALT-FUNCTION SIGNALING AND COMPLETION 



Subsequent to the attempt to choose a 
channel path, the channel subsystem, if 
conditions allow, attempts to select the 
device to issue the halt signal. (See 
the section "Halt Signal" in Chapter 17, 
"I/O Support Functions.") Conditions 
associated with the subchannel and the 
chosen channel path, if any, affect 
(1) whether an attempt is made to issue 
the halt signal, (2) whether the attempt 
to issue the halt signal is successful, 
and (3) whether the subchannel is made 
status-pending to complete the halt 
function. These conditions and their 
effect on the halt function are 
described as follows: 

No Attempt Is Made to Issue the Halt 
Sjjgnal.: The channel subsystem does not 
attempt to issue the halt signal to the 
device if any of the following condi- 
tions exist: 

1. No channel path was chosen. (See 
the section "Halt-Function Path 
Management" earlier in this 
chapter. ) 

2. The chosen channel path is no long- 
er available for selection. 

3. A channel-path-terminal condition 
exists for the chosen channel path. 

4. The associated subchannel is 
status-pending with other than 
intermediate status alone. 



5. The device to be signaled is 
attached to a type-1 control unit, 
and the subchannel for another 
device attached to the same control 
unit has an allegiance to the same 
channel path, unless the allegiance 
is a working allegiance and primary 
status has been accepted by that 
subchannel . 

6. The device to be signaled is 
attached to a type-3 control unit, 
and the subchannel for another 
device attached to the same control 
unit has a dedicated allegiance to 
the same channel path. 

If the conditions described in items 3, 
5, or 6 above exist, the associated 
subchannel remains halt-pending until 
those conditions no longer exist. When 
the conditions no longer exist (for the 
channel-path-terminal condition, when 
the condition no longer exists as a 
result of executing RESET CHANNEL PATH) 
the channel subsystem attempts to issue 
the halt signal to the device. 

If any of the remaining conditions above 
exist, the subchannel remains halt- 
pending, is set status-pending, and the 
halt function is complete. 

The Attempt to Issue the Halt Si gnal Is 
Not Successful : When the channel 
subsystem attempts to issue the halt 
signal to the device, the attempt may 
not be successful because of the follow- 
ing conditions: 

1. The control unit or device signals 
a busy condition when the channel 
subsystem attempts to select the 
device to issue the halt signal. 

2. A path-not-operational condition is 
recognized when the channel subsys- 
tem attempts to select the device 
to issue the halt signal. 

3. An error condition is encountered 
when the channel subsystem attempts 
to issue the halt signal. 

If the control unit or device signals a 
busy condition (item 1 above), the 
subchannel remains halt-pending until 
the internal indication of busy is 
reset. When this event occurs, the 
channel subsystem again attempts to 
issue the halt signal to the device. 

If any of the remaining conditions above 
exists and the channel subsystem either 
determines that the attempt to issue the 
halt signal was not successful or cannot 
determine whether the attempt was 
successful, then the subchannel remains 
halt-pending and is set status-pending, 
and the halt function is complete. 

The Attempt to Issue the Halt Si gnal Is 
Successful : When the channel subsystem 
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When the subchannel is subchannel-and- 
devi ce-acti ve or only device-active 
during the performance of the halt func- 
tion, the state continues until the 
subchannel is made status-pending 
because (1) the device has provided 
ending status or (2) the channel subsys- 
tem has determined that ending status is 
unavailable. When the subchannel is 
idle, start-pending, start-pending and 
resume-pending, suspended, or suspended 
and resume-pending, or when the halt 
signal is issued during command chaining 
after the receipt of device end but 
before the next command is transferred 
to the device, no operation is in 
progress at the device, and therefore no 
status is generated by the device as a 
result of receiving the halt signal. In 
this situation, an interruption condi- 
tion indicating status-pending alone is 
generated after the halt signal is 
i ssued. 

The effect of the halt signal at the 
device depends partially on the type of 
device and its state. The effect of the 
halt signal on a device that is not 
active or that is executing a mechanical 
operation in which data is not trans- 
ferred across the channel path, such as 
rewinding tape or positioning a disk- 
access mechanism, depends upon the 
control-unit or device model. If the 
device is executing a type of operation 
that is unpredictable in duration or in 
which data is transferred across the 
channel path, the control unit intei — 
prets the signal as one to terminate the 
operation. Pending status conditions at 
the device are not reset. When the 
control unit recognizes the halt signal, 
it immediately ceases all communication 
with the channel subsystem until it has 
reached the normal ending 
control unit then requests 
the channel subsystem to 
generated status. 
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end for the current I/O operation, the 
channel subsystem causes the device to 
be disconnected and command chaining or 
command retry to be suppressed. If the 
subchannel is executing a chain of I/O 
operations with the device and the halt 
signal is issued during command chaining 
at a point after the receipt of device 
end for the previous I/O operation but 
before the next command is transferred 
to the device, the subchannel is made 
status-pending with primary and second- 
ary status immediately after the halt 
signal is issued. The device-status 
field of the SCSW contains zeros in this 
case. If the halt function is addressed 
to a subchannel that is start-pending 
and the halt-pending condition is recog- 
nized before initiation of the start 
function, initiation of the start func- 
tion is not attempted, and the 
subchannel becomes status-pending after 
the device has been signaled. 

When the subchannel is not executing an 
I/O operation with the associated 
device, the device is selected, and an 
attempt is made to issue the halt signal 
as the device responds. If the subchan- 
nel is in the device-active state, the 
subchannel becomes status-pending, only 
after receiving the device-end status 
from the halted device. If the subchan- 
nel is neither subchannel-and-devi ce- 
acti ve nor device-active, the subchannel 
becomes status-pending immediately after 
selecting the device and issuing the 
halt signal. The SCSW for the latter 
case has the status-pending bit set to 
one Csee the section "Subchannel-Status 
Word" in Chapter 16, "I/O 
Interruptions") . 

The termination of an I/O operation by 
performing the halt function may result 
in two distinct interruption conditions. 

The first interruption condition occurs 
when the device generates the channel- 
end condition. The channel subsystem 
handles this condition as it would any 
other interruption condition from the 
device, except that the command address 
in the associated SCSW designates the 
point at which the I/O operation is 
terminated, and the subchannel-status 
bits may reflect unusual conditions that 
were detected. If the halt signal was 
issued before all data designated for 
the operation had been transferred, 
incorrect length is indicated, subject 
to the control of the SLI flag in the 
current CCW. The value in the count 
field of the associated SCSW is unpre- 
di ctable. 

The second interruption condition occurs 
if device-end status was not presented 
with the channel-end interruption condi- 
tion. In this situation, the 
subchannel-key, command-address, and 
count fields of the associated SCSW are 
not meaningful. 
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Nhen HALT SUBCHANNEL terminates an I/O 
operation, the method of termination 
differs from that used upon exhaustion 
of count or upon detection of program- 
ming errors to the extent that termi- 
nation by HALT SUBCHANNEL is not 
contingent on the receipt of a service 
request from the associated device. 



Programme nq Notes 



When, after an operation is termi- 
nated by HALT SUBCHANNEL, the 
subchannel is status-pending with 
primary, primary and secondary, or 
secondary status, the extent of 
data transferred as described by 
the count field is unpredictable. 

When the path that is chosen by the 
path-management operation has a 
channel-path-terminal condition 
associated with it, the halt func- 
tion remains pending until the 
condition no longer exists. Until 
the condition is cleared, the asso- 
ciated subchannel cannot be used to 
execute I/O operations, even if 
other channel paths become avail- 
able for selection. CLEAR 
SUBCHANNEL can be executed to 
terminate the halt-pending condi- 
tion and make the subchannel 
usable. 



START FUNCTION AND RESUME FUNCTION 



Subsequent to execution of START 
SUBCHANNEL and RESUME SUBCHANNEL, the 
channel subsystem performs the start and 
resume functions, respectively, to 
initiate an I/O operation with the asso- 
ciated device. Performance of a start 
or resume function consists in: 
(1) executing a path-management opera- 
tion, (2) executing an I/O operation or 
chain of I/O operations with the associ- 
ated device, and (3) causing the 
subchannel to be made status-pending, 
indicating completion of the performance 
of the start function. (Completion of a 
start function is described in Chapter 
16, "I/O Interruptions.") The start 
function initiates the execution of a 
channel program that is designated in 
the ORB, which in turn is designated as 
the operand of START S.UBCHANNEL, in 
contrast to the resume function which 
initiates the execution of a suspended 
channel program, if any, beginning at 
the CCW that caused suspension; other- 
wise, the resume function is performed 
as if it were a start function (see the 
discussion on the resume-pending bit in 
the section "Activity Control" in Chap- 
ter 16, "I/O Interruptions"). 



START-FUNCTION AND RESUME-FUNCTION PATH 
MANAGEMENT 



A path-management operation is executed 
by the channel subsystem during the 
performance of either a start or resume 
function to choose an available channel 
path that can be used for device 
selection to initiate an I/O operation 
with that device. The actions taken are 
as follows: 



1. 



4. 



If the subchannel is currently 
start-pending and device-active, 
the start function remains pending 
at the subchannel until the second- 
ary status for the previous start 
function has been accepted from the 
associated device and the subchan- 
nel is made start-pending alone. 
When the status is accepted and it 
does not describe an alert inter- 
ruption condition, the subchannel 
is not made status-pending, and the 
performance of the pending start 
function is subsequently initiated. 
If the status describes an alert 
interruption condition, the 
subchannel becomes status-pending 
with secondary and alert status, 
the pending start function is not 
initiated, deferred condition code 
1 is set, and the start-pending bit 
remains one. If the subchannel is 
currently start-pending alone, the 
performance of the start function 
is initiated as described below. 

If a dedicated allegiance exists at 
the subchannel for a channel path, 
the channel subsystem chooses that 
path for device selection. If a 
busy condition is encountered while 
attempting to select the device and 
a dedicated allegiance exists at 
the subchannel, the start function 
remains pending until the internal 
indication of busy is reset for 
that channel path. When the inter- 
nal indication of busy is reset, 
the performance of the pending 
start function is initiated on that 
channel path. 
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If all channel paths that are 
available for selection have been 
tried and one or more of them are 
being used to actively communicate 
with other devices, or, alterna- 
tively, if the channel subsystem 
has encountered either a control- 
unit-busy or device-busy condition 
on one or more of those channel 
paths, or a combination of those 
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conditions on one or more of those 
channel paths* the start function 
remains pending at the subchannel 
until a channel path, control unit, 
or device, as appropriate, becomes 
avai lable. 

5. If (1) the start function is to be 
initiated on a channel path with a 
device attached to a type-1 control 
unit and (2) no other device is 
attached to the same control unit 
whose subchannel has either a dedi- 
cated allegiance to the same 
channel path or a working alle- 
giance to the same channel path 
where primary status has not been 
received for that subchannel, then 
path is chosen if it 
for selection; othei — 
channel path is not 
however, another chan- 
the device is available 



that channel 
i 5 avai lable 
wise, that 
chosen. If, 
nel path to 



for selection and if no allegiances 
exist as described above, that 
channel path is chosen. If no 
other channel paths are available 
for selection, the start or resume 
function, as appropriate, remains 
pending until a channel path 
becomes available. 

If the device is attached to a 
type-3 control unit and if at least 
one other device is attached to the 
same control unit whose subchannel 
has a dedicated allegiance to the 
same channel path, another channel 
path that is available for 
selection may be chosen, or the 
start function remains pending 
until the dedicated allegiance for 
the other device is cleared. 
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If, during an attempt to select the 
device in order to initiate 
execution of the first command 
specified for the start or implied 
for the resume function (as 
described if action 7), the channel 
subsystem receives a busy indi- 
cation, it performs one of the 
following actions? 

a. If the device is specified to 
be operating in mult i path mode 
and the busy indication 
received is device busy, then 
the start or resume function 
remains pending until the 
internal indication of busy is 



reset. (See the section 
"Subchannel-Information Block" 
earlier in this chapter, 
concerning mult i path mode.) 

If the device is specified to 
be operating in mult i path mode 
and the busy indication 
received is control-unit busy, 
or if the device is specified 
to be operating in single-path 
mode, the channel subsystem 
attempts selection of the 
device by choosing an alternate 
channel path that is available 
for selection and continues the 
path-management operation until 
either the start or resume 
function is initiated or 
selection of the device has 
been attempted on all channel 
paths that are available for 
selection. If 
resume function 
initiated by 
subsystem after 
paths available 
have been chosen, 



the start or 
has not been 
the channel 
all channel 
for selection 
the start or 
resume function remains pending 
until the internal indication 
of busy i s reset. 

c. If the subchannel has a dedi- 
cated allegiance, then action 2 
applies. 

9. When, during the selection attempt 
to transfer the first command, the 
device appears not operational and 
the corresponding channel path is 
operational for the subchannel, a 
path-not-operational condition is 
recognized and the state of the 
channel path changes at the 
subchannel from operational for the 
subchannel to not operational for 
the subchannel (see the section 
"Subchannel-Information Block" 
earlier in this chapter). The 
path-not-operational conditions at 
the subchannel, if any, are 
preserved until the subchannel next 
becomes cleai — pending, start- 
pending, or resume-pending (if the 
subchannel was suspended), at which 
time the path-not-operational 
conditions are cleared. If, howev- 
er, the corresponding channel path 
is not operational for the subchan- 
nel, a path-not-operational 
condition is not recognized. When 
the device appears not operational 
during the selection attempt to 
transfer the first command on a 
channel path that is available for 
selection, one of the following 
actions occurs: 

a. If a dedicated allegiance 
exists for that channel path, 
then it is the only channel 
path that is available for 
selection; therefore, further 
attempts to initiate the start 
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or resume function are aban- 
doned, and an interruption 
condition is recognized. 

b. If no dedicated allegiance 
exists and there are alternate 
channel paths available for 
selection which have not been 
tried, one of those channel 
paths is chosen to attempt 
device selection and transfer 
the first command. 

c. If no dedicated allegiance 
exists, no alternate channel 
paths are available for 
selection which have not been 
tried, and the device has 
appeared operational on at 
least one of the channel paths 
that were tried, the start or 
resume function remains pending 
at the subchannel until either 
a channel path, a control unit, 
or the device, as appropriate, 
becomes available. 



chapter), the subchannel is active from 
the acceptance of the first command 
until the primary interruption condition 
is recognized at the subchannel. If the 
primary interruption condition is recog- 
nized before the acceptance of the first 
command, the subchannel does not become 
active. Normally, the primary intei — 
ruption condition is caused by the 
channel-end signal or, in the case of 
command chaining, the channel-end signal 
for the last CCW of the chain. (See the 
section "Primary Interruption Condition" 
in Chapter 16, "I/O Interruptions.") 
The device is active until the secondary 
interruption condition is 
the subchannel. Normally, 
interruption condition is 
device-end signal or, in 
command chaining, the device-end signal 
for the last CCW of the chain. (See the 
section "Secondary Interruption Condi- 
tion" in Chapter 16, "I/O Interrup- 
tions.") 
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If no dedicated allegiance 
exists, no alternate channel 
paths are available for 
selection which have not been 
tried, and the device has 
appeared not operational on all 
channel paths that were tried, 
further attempts to initiate 
the start or resume function 
are abandoned, and an inter- 
ruption condition is recog- 
nized. 



Programming Note 
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10. When the subchannel is active and 
an I/O operation is to be initiated 
with a device, all device 
selections occur according to the 
LPUM indication if the multipath 
mode is not specified at the 
subchannel. For example, if 
command chaining is specified, the 
channel subsystem transfers the 
first and all subsequent commands 
describing a chain of I/O opei — 
ations over the same channel path. 



EXECUTION OF I/O. OPERATIONS 



After a channel path is chosen, the 
channel subsystem, if conditions allow, 
initiates execution of an I/O operation 
with the associated device. Execution 
of additional I/O operations may follow 
initiation and execution of the first 
I/O operation. The channel subsystem 
can execute seven commands: write, 
read, read backward, control, sense, 
sense ID, and transfer in channel. Each 
command, except transfer in channel, 
initiates a corresponding I/O operation. 
Except for periods while channel-program 
execution is suspended at the subchannel 
(see the section "Suspension of 
Channel-Program Execution" later in this 



When the device has the dynamic- 
reconnection feature installed, an I/O 
operation or chain of I/O operations may 
be executed in multipath mode; to opei — 
ate in multipath mode, MODIFY SUBCHANNEL 
must have been previously executed for 
the subchannel with bit 13 of word 1 of 
the SCHIB specified as one. (See the 
description of the mult i path-mode bit in 
the section "Subchannel-Information 
Block" earlier in this chapter.) In 
addition, the device must be set up for 
multipath mode by execution of certain 
model-dependent commands appropriate to 
that type of device. The general proce- 
dures for handling multi path-mode 
operations are as follows; 

1. Setup 

a. A set-mult i path-mode type of 
command must be successfully 
executed by the device on each 
channel path that is to be a 
member of the multipath group 
being set up; otherwise, the 
multipath mode of operation may 
give unpredictable results at 
the subchannel. If, for any 
reason, one or more physically 
available channel paths to the 
device are not included in the 
multipath group, these channel 
paths must not be available for 
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selection while the subchannel 
is operating in multipath mode. 
A channel path can be made not 
available for selection by 
having the corresponding LPM 
bit set to zero either in the 
SCHIB prior to executing STORE 
SUBCHANNEL or in the ORB prior 
to executing START SUBCHANNEL. 
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Leaving Multipath Mode 

To leave multipath mode and contin- 
ue processing in single-path mode, 
either of the following two proce- 
dures may be used: 

a. A di sband-multi path-mode type 
of command may be executed for 
any channel path of the multi- 
path group. This command must 
be followed either by (1) the 
execution of MODIFY SUBCHANNEL 
with bit 13 of word 1 of the 
SCHIB specified as zero, or by 
(2) the specification of only a 
single channel path as 
logically available in the LPM. 
A start function must not be 
performed at a subchannel oper- 
ating in multipath mode with 
multiple channel paths avail- 
able for selection while the 
device is operating in single- 
path mode; otherwise, 
unpredictable results may occur 
at the subchannel for that 
function or subsequent start 
functi ons. 

b. A resi gn-multi path-mode type of 
command i s executed on each 
channel path of the multipath 
group (the reverse of the setup 
described in item 1 above). 
This command must be followed 
by either (1) the execution of 
MODIFY SUBCHANNEL with bit 13 
of word 1 of the SCHIB speci- 
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BLOCKING OF DATA 



Data recorded by an I/O device is 
divided into blocks. The length of a 
block depends on the device; for 
example, a block can be a card, a line 
of printing, or the information recorded 
between two consecutive gaps on magnetic 
tape. 
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OPERATION-REQUEST BLOCK (ORB) 



The operation-request block (ORB) is the 
operand of START SUBCHANNEL. The ORB 
specifies the parameters to be used in 
controlling that particular start func- 
tion. These parameters include the 
interruption parameter, the subchannel 
key, the address of the first CCW, 
operation-control bits, and a specifica- 
tion of the logical availability of 
channel paths. The contents of the ORB 
are placed at the designated subchannel 
during the execution of START 
SUBCHANNEL, prior to the setting of 
condition code 0. If the execution of 
START SUBCHANNEL results in the setting 
of a nonzero condition code, the 
contents of the ORB have not been placed 
at the designated subchannel. The two 
rightmost bits of the ORB address must 
be zeros, placing the ORB on a word 
boundary; otherwise, a specification 
exception is recognized. The format of 
the ORB is as follows: 
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Interruption Parameter 


1 


Key 


S 


000 


F 


P 


I 


A 


U 


000 


LPM 


L 


0000000 


2 


Channel-Program Address 



ORB Format 



31 



The fields 
follows: 



in the ORB ere defined as 



Interruption Parameter : Bits 0-31 of 
word are preserved unmodified in the 
subchannel until replaced by a subse- 
quent START SUBCHANNEL or MODIFY 
SUBCHANNEL instruction. These bits are 
placed in word 1 of the interruption 
code when an I/O interruption occurs and 
when an interruption request is cleared 
by execution of TEST PENDING INTER- 
RUPTION. 



Subchannel Key : Bits 0-3 of 
the subchannel key for all 
CCWs, IDAWs, and output data 
storing of input data asso 
the start function initiat 
SUBCHANNEL. This key is ma 
storage key during these st 
ences. For details, see 
"Key-Controlled Protection" 
3, "Storage." 



word 1 form 

fetching of 

and for the 

ciated with 

ed by START 

tched with a 

or&ge refer- 

the section 

in Chapter 



Suspend Control (S) : Bit 4 of word 1 
controls the performance of the suspend 
function for the channel program identi- 
fied in the ORB. The setting of the S 
bit applies to all CCWs of the channel 
program designated by the ORB (see the 
section "Commands" later in this 
chapter). When bit 4 is one, suspend 
control is specified, and channel- 
program suspension occurs when a valid 
suspend flag is detected in a CCW. If 
suspend control is not 
the presence of the 
any CCW of the channel 
program-check condition 



bit 4 is zero, 
specified, and 
suspend flag in 
program causes a 
to be recognized. 



Reserved : Bits 5-7 of word 1 are 
reserved for future use and must be 
zeros; otherwise, either an operand 
exception or a program-check condition 
is recognized. 

Format Control ( F) : Bit 8 of word 1 
specifies the format of the channel- 
command words (CCWs) which make up the 
channel program designated by the 
channel-program-address field. If bit 8 
of word 1 is zero, format-0 CCWs are 
specified. If bit 8 is one, format-1 
CCWs are specified. (See the section 
"Channel-Command Word" later in this 
chapter, for the definition of the CCW 
formats) . 

Prefetch Control ( P) : Bit 9 of word 1 
specifies whether or not unlimited 



prefetching of CCWs is allowed for the 
channel program. If this bit is zero, 
no prefetching is allowed, except in the 
case of data chaining on output, where 
the prefetching of one CCW describing a 
data area is allowed. If this bit is 
one, unlimited prefetching is allowed. 

Ini tial-Status-Interruption Control (£) : 
Bit 10 of word 1 specifies whether or 
not the channel subsystem must verify to 
the program that the device has accepted 
the first command associated with a 
start or resume function. If the I bit 
is specified as one in the ORB, then 
when initial status is received and the 
subchannel becomes active, indicating 
that the first command has been accepted 
for this start or resume function, the Z 
bit (see the section "Subchannel-Status 
Word" in Chapter 16, "I/O 
Interruptions") is set to one at this 
subchannel, and the subchannel becomes 
status-pending with intermediate status. 

If the subchannel does not become 
active — for example, when the device 
signals channel end immediately upon 
receiving the first command, command 
chaining is not specified in the CCW, 
and command retry is not signaled — the 
command-accepted condition (Z bit set to 
one) is not generated; instead, the 
subchannel becomes status-pending with 
primary status; intermediate status may 
also be indicated in this case when the 
command is accepted if the first CCW 
contained the PCI flag. 

Address-L i mi t-Checki ng Control (A): Bit 
11 of word 1 specifies whether or not 
address-limit checking is specified for 
the channel program. If this bit is 
zero, no address-limit checking is 
performed for the execution of the chan- 
nel program, independent of the setting 
of the limit-mode bits in the subchannel 
(see the section "Path-Management- 
Control Word" earlier in this chapter). 
If this bit is one, address-limit check- 
ing is allowed for the channel program, 
subject to the setting of the limit-mode 
bits in the subchannel. 

Suppress-Suspended-Interrupti on Control 
(U) : Bit 12 of word 1, when one, speci- 
fies that the channel subsystem is to 
suppress the generation of an intermedi- 
ate interruption condition due to 
suspension if the subchannel becomes 
suspended. When bit 12 is zero, the 
channel subsystem generates an interme- 
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diate interruption condition whenever 
the subchannel becomes suspended during 
execution of the channel program. 

Reserved : Bits 13-15 of word 1 are 
reserved for future use and must be 
zeros; otherwise, an operand exception 
or a program-check condition is recog- 
nized. 

Logical-Path Mask (LPM): Bits 16-23 of 
word 1 are preserved unmodified in the 
subchannel and specify to the channel 
subsystem which of the logical paths 0-7 
are to be considered logically 
available, as viewed by the program. A 
bit setting of one means that the corre- 
sponding channel path is logically 
available; a zero specifies that the 
corresponding channel path is logically 
not available. If a channel path is 
specified by the program as being 
logically not available, the channel 
subsystem does not use that channel path 
to perform clear, halt, resume, or start 
functions when requested by the program, 
except when a dedicated-allegiance 
condition exists for that channel path. 
If a dedicated-allegiance condition 
exists, the setting of the LPM is 
ignored, and a resume, start, halt, or 
clear function is performed by using the 
channel path having the dedicated- 
allegiance. 

Incorrect-Length-Suppressi on Mode ( L.) : 
When the incorrect-length-indication- 
suppression facility is installed and 
bit 8 of word 1 is one, then bit 24 of 
word 1, when one, specifies the 
incorrect-length-suppression mode. If 
the subchannel is in this mode when an 
immediate operation occurs (that is, a 
device signals the channel-end condition 
during the initiation sequence) and the 
current CCW contains a nonzero value in 
bits 16-31, indication of an incorrect- 
length condition is suppressed. 

When the incorrect-length-indication- 
suppression facility is installed and 
bit 8 of word 1 is one, then bit 24 of 
word 1, when zero, specifies the 
incorrect-length-indication mode. If 
the subchannel is in this mode when an 
immediate operation occurs (that is, a 
device signals the channel-end condition 
during the initiation sequence) and the 
current CCW contains a nonzero value in 
bits 16-31, indication of an incorrect- 
length condition is recognized. Command 
chaining is suppressed unless the SLI 
flag in the CCW is one and the chain- 
data flag is zero. 

When the incorrect-length-indication- 
suppression facility is installed and 
bit 8 of word 1 is zero, the value of 
bit 24 is ignored by the channel subsys- 
tem, and the subchannel is in the 
i ncorrect-length-suppressi on mode. 

When the incorrect-length-indication- 
suppression facility is not installed 



and bit 24 of word 1 is zero, the 
subchannel is in the incorrect-length- 
suppression mode. When the incorrect- 
length-indicati on- suppress i on faci li ty 
is not installed, bit 24 must be zero; 
otherwise, an operand exception is 
recogni zed. 

Reserved ? Bits 25-31 of word 1 are 
reserved for future use and must be set 
to zeros; otherwise, an operand excep- 
tion or a program-check condition is 
recogni zed. 

Channel -Program Address ? Bits 0-31 of 
word 2 designate the location of the 
first CCW in absolute storage. If 
format-0 CCWs have been specified in bit 
8 of word 1, then bits 0-7 of word 2 
must be zeros. If format-1 CCWs have 
been specified, then bit of word 2 
must be zero; otherwise, an operand 
exception or a program-check condition 
is recognized. If format-0 CCWs have 
been specified and bits 1-7 do not 
contain zeros, a program-check condition 
is recognized. 

The three rightmost bits of the 
channel-program address must be zeros, 
designating the CCW on a doubleword 
boundary; otherwise, a program-check 
condition is recognized. 

If the channel-program address desig- 
nates a location protected against 
fetching or designates a location 
outside the storage of the particular 
installation, the start function is not 
initiated at the device. In this situ- 
ation, the subchannel becomes status- 
pending with primary, secondary, and 
alert status. 



Proorammi ng Notes 



Bit positions of the ORB which 
presently are specified to contain 
zeros may in the future be assigned 
for the control of new functions. 

The interruption parameter may 
contain any information, but ordi- 
narily the information is of 
significance to the program handl- 
ing the I/O interruption. 



CHANNEL-COMMAND WORD 



The channel-command word (CCW) specifies 
the command to be executed and, for 
commands initiating certain I/O oper- 
ations, it designates the storage area 
associated with the operation, the 
action to be taken whenever transfer to 
or from the area is completed, and other 
options. 
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A channel program consists of one or 
more CCWs that are logically linked such 
that they are fetched by the channel 
subsystem and executed in the sequence 
the CPU program. Contig- 
linked by the use of the 
chain-command flags, and 
CCWs may be linked by a 
the transfei — in-channel 



specified by 
uous CCWs are 
chain-data or 
noncont i guous 
CCN specifying 
command. 



As each CCW is executed, it is recog- 
nized as the current CCW. A CCW becomes 
current (1) when it is the first CCW of 
a channel program and has been fetched, 

(2) when, during command chaining, the 
new CCW is logically fetched, or 

(3) when, during data chaining, the new 
CCW takes over control of the I/O opera- 
tion (see the section "Data Chaining" 
later in this chapter). When chaining 
is not specified, a CCW is no longer 
current after TEST SUBCHANNEL clears the 
start-function bit in the subchannel. 

The location of the first CCW of the 
channel program is designated in the ORB 
that is the operand of START SUBCHANNEL. 
The first CCW is fetched subsequent to 
the execution of the instruction. The 
format of the CCWs fetched by the chan- 
nel subsystem is specified by bit 8 of 
word 1 of the ORB. Each additional CCW 
in the channel program is obtained when 
the CCW is needed. Fetching of the CCWs 
by the channel subsystem does not affect 
those locations in main storage. 

CCWs have either of two different 
formats, format or format 1. The two 
formats do not differ in the information 
contained in the CCW but only in the 
arrangement of the fields within the 
CCW. 

The formats are defined as follows: 

Format-0 CCW 



Cmd Code 



Data Address 



31 



Flags 





//////// 


Count 



32 



39 



48 



63 



Format-1 CCW 



Cmd Code 


Flags 





Count 


8 15 


31 





Data Address 



32 



63 



Format-0 CCWs can be 
the first 16,777,216 
age. 



located anywhere in 
bytes of main stor- 



Format-1 CCWs can be located anywhere in 
main storage. 

Bit 39 (format 0) or bit 15 (format 1) 
of every CCW other than a format-0 CCW 
specifying transfer in channel must be 
zero. Additionally, if indirect data 
addressing is specified, bits 30-31 
(format 0) or bits 62-63 (format 1) of 
the CCW must be zeros, designating a 
word boundary, and bit of the first 
entry of the indirect-data-address list 
must be zero. Otherwise, a program- 
check condition may be generated (see 
the section "CCW Indirect Data Address- 
ing" later in this chapter). Detection 
of this condition during data chaining 
causes the I/O device to be signaled to 
conclude the operation. When the 
absence of these zeros i s detected 
during command chaining or subsequent to 
the execution of START SUBCHANNEL, the 
new operation is not initiated, and an 
interruption condition is generated. 

The contents of bit positions 40-47 of a 
format-0 CCW are ignored. 

The fields in the CCWs are defined as 
follows: 

Command Code: Bits 0-7 (both formats) 
specify the operation to be executed. 

Data Address : Bits 8-31 (format 0) or 
bits 33-63 (format 1) designate a 
location in absolute storage. It is the 
first location referred to in the area 
designated by the CCW. If a byte count 
of zero is specified, this field is not 
checked. 

Chain-Data (CD) Flag : Bit 32 (format 0) 
or bit 8 (format 1), when one, specifies 
chaining of data. It causes the storage 
area designated by the next CCW to be 
used with the current I/O operation. 
When the CD flag is one in a CCW, the 
chain-command and suppress-length- 
indication flags (see below) are 
i gnored. 

Chai n-Command (CO Flag : Bit 33 (format 
0) or bit 9 (format 1), when one, and 
when the CD flag and S flag are both 
zeros, specifies chaining of commands. 
It causes the operation specified by the 
command code in the next CCW to be 
initiated on normal completion of the 
current operation. 

Suppress-Length-Indi cati on ( SLI ) Flag : 
Bit 34 (format 0) or bit 10 (format 1) 
controls whether an incorrect-length 
condition is to be indicated to the 
program. When this bit is one and the 
CD flag is zero, the incorrect-length 
indication is suppressed. When both the 
CC and SLI flags are ones, and the CD 
flag is zero, command chaining takes 



15-24 370-XA Principles of Operation 



place, regardless of the presence of an 
incorrect-length condition. This bit 
should be specified in all CCWs where 
suppression of the incorrect-length 
indication is desired. 

Skip ( SKIP ) Flag : Bit 35 (format 0) or 
bit 11 (format 1), when one, specifies 
the suppression of transfer of informa- 
tion to storage during a read, read- 
backward, sense ID, or sense operation. 

Program-Control led-Interrupti on ( PCI ) 
Flag : Bit 36 (format 0) or bit 12 (for- 
mat 1), when one, causes the channel 
subsystem to generate an intermediate 
interruption condition 
takes control of the 
When the PCI flag bit 
operation takes place. 



when the CCW 

I/O operation. 

is zero, normal 



Indi rect-Data-Address ( IDA ) Flag: Bit 
37 (format 0) or bit 13 (format 1), when 
one, specifies indirect data addressing. 

Suspend (S) Flag : Bit 38 (format 0) or 
bit 14 (format 1), when one, specifies 
suspension of channel-program execution. 
When valid, it causes channel-program 
execution to be suspended prior to 
execution of the CCW containing the S 
flag. The S flag is valid when bit 4, 
word 1 of the associated ORB is one. 

Count : Bits 48-63 (format 0) or bits 
16-31 (format 1) specify the number of 
bytes in the storage area designated by 
the CCW. 



Output forward (write, control) 
Input forward (read, sense, sense 

ID) 
Input backward (read backward) 
Branching (transfer in channel) 

The channel subsystem ignores the left- 
most bits of the command code, except in 
a format-1 CCW specifying transfer in 
channel. In this situation, all bits of 
the command code are decoded by the 
channel subsystem. 

Commands that initiate I/O operations 
(write, read, read backward, control, 
sense, and sense ID) cause all eight 
bits of the command code to be trans- 
ferred to the control unit. In these 
command codes, the leftmost bit posi- 
tions contain modifier bits. The 
modifier bits specify to the device how 
the command is to be executed. They 
may, for example, cause the device to 
compare data received during a write 
operation with data previously recorded, 
and they may specify such conditions as 
recording density and parity. For the 
control command, the modifier bits may 
contain the order code specifying the 
control function to be executed. The 
meaning of the modifier bits depends on 
the type of I/O device and is specified 
in the System Library publication for 
the device. 

The command-code assignment is listed in 
the figure "Command-Code Assignment." 
The symbol x indicates that the bit 
position is ignored; m identifies a 
modifier bit. 



Programmi ng Note 



Bit 39 of a format-0 CCW or bit 15 of a 
format-1 CCW, which presently must be 
zero, may in the future be assigned for 
the control of new functions. It is 
recommended, therefore, that this bit 
position not be set to one for the 
purpose of obtaining an intentional 
program-check indication. 



COMMAND CODE 



The command code, bit positions 0-7 of 
the CCW, specifies to the channel 
subsystem and the I/O device the opera- 
tion to be executed. A detailed 
description of each command appears 
under "Commands," later in this chapter. 

The two rightmost bits or, when these 
bits are zeros, the four rightmost bits 
of the command code identify the opera- 
tion to the channel subsystem. The 
channel subsystem distinguishes among 
the following four operations: 



Code 


Command 


xxxx 0000 
mmmm mm 01 
mmmm mmlO 
mmmm 1100 
mmmm mm 11 
mmmm 0100 
1110 0100 
xxxx 100 
0000 1000 
mmmm 10 


Inval i d 

Wri te 

Read 

Read backward 

Control 

Sense 

Sense ID 

Transfer in channel 1 

Transfer in channel 2 

Invali d 3 


Explanat i on 




1 Format- 

2 Format- 

3 Format- 
bits o- 

m Modifi 

x Ignore 


-0 CCW 

-1 CCW 

-1 CCW with any of 
-3 nonzero 

ar bi t 

d 



Command-Code Assignment 
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Whenever the channel subsystem detects 
an invalid command code during the 
initiation of command execution, the 
program-check-interruption condition is 
generated and channel-program execution 
is terminated. The command code is 
ignored during data chaining, unless it 
specifies transfer in channel. 



DESIGNATION OF STORAGE AREA 



The main-storage area 
I/O operation is defi 
CCUs. A CCUI defines 
nating the address of 
be transferred and th 
utive bytes contained 
address of the first 
data-address field 
number of bytes conta 
area is specified in 



associated with an 
ned by one or more 

an area by desig- 

the first byte to 

e number of consec- 

in the area. The 
byte appears in the 
of the CCW. The 
ined in the storage 
the count field. 



In write, read, control, sense, and 
sense-ID operations, storage locations 
are used in ascending order of 
addresses. As information is trans- 
ferred to or from main storage, the 
address from the address field is incre- 
mented, and the count from the count 
field is decremented. The read-backward 
operation places data in storage in a 
descending order of addresses, and both 
the count and the address are decre- 
mented. When the count reaches 0, the 
storage area defined by the CCW is 
exhausted. 

Any main-storage location available to 
the start function can be used in the 
transfer of data to or from an I/O 
device, provided that the location is 
not protected against that type of 
reference. Format-0 CCWs can be located 
in any available part of the first 16M 
bytes of storage, and format-1 CCWs can 
be located in any part of available 
storage, provided in both cases that the 
location is not protected against a 
fetch-type reference. When the channel 
subsystem attempts to refer to a 
protected location, the protection-check 
condition is generated, and the device 
is signaled to terminate the operation. 

A main-storage location is available if 
it is provided and access to it is not 
prevented by the address-limit-checking 
facility. If a main-storage location is 
not available, it is said to have an 
invalid address. 

If the channel subsystem refers to a 
location not provided in the system, the 
program-check condition is generated. 
When the first CCW designated by the 
channel-program address i s at a nonex- 
istent location, the start function is 
not initiated at the device, the status 
portion of the SCSW is updated with the 
program-check indication, and the 
subchannel becomes status-pending with 



primary, secondary, and alert status, 
and deferred condition code 1 is indi- 
cated. Invalid data addresses, as well 
as any invalid CCW addresses detected on 
chaining or subsequent to the execution 
of START SUBCHANNEL, cause the channel 
subsystem to signal the device to 
conclude the operation the next time the 
device requests or offers a byte of data 
or status. In this situation, the 
subchannel is made status-pending with 
program check indicated in the subchan- 
nel status; the device status is a 
function of the status received from the 
device. The program-check condition 
causes command chaining and command 
retry to be suppressed. 

During an output operation, the channel 
subsystem may fetch data from main stor- 
age before the time the I/O device 
requests the data. Any number of bytes 
specified by the current CCW may be 
prefetched and buffered. When data 
chaining during an output operation, the 
channel subsystem may fetch one CCW 
describing a data area at any time 
during the execution of the current CCW. 
If unlimited prefetching is allowed by 
the setting of the prefetch-control bit 
in the ORB, then any number of CCWs may 
be prefetched by the channel subsystem. 
When the I/O operation uses data and 
CCWs from locations near the end of the 
available storage, such prefetching may 
cause the channel subsystem to refer to 
locations that do not exist. Invalid 
addresses detected during prefetching of 
data or CCWs do not affect the execution 
of the operation and do not cause error 
indications until the I/O operation 
actually attempts to use the 
information. If the operation is 
concluded by the I/O device or by 
execution of HALT SUBCHANNEL or CLEAR 
SUBCHANNEL before the invalid informa- 
tion is needed, the condition is not 
brought to the attention of the program. 

The count field in the CCW can specify 
any number of bytes up to 65,535. In 
format-0 CCWs, the count field is always 
nonzero unless the command code speci- 
fies transfer in channel, in which case 
the count field is ignored. In format-1 
CCWs, the count field may contain the 
value zero unless data chaining is spec- 
ified or the CCW is fetched while data 
chaining. Whenever (1) the count field 
in a format-1 CCW is zero, (2) data 
chaining is either not specified or is 
not in effect, and (3) data transfer is 
requested by the device, the device is 
signaled to stop, and the I/O operation 
is terminated. The channel subsystem 
sets the incorrect-length condition if 
the SLI flag is not one in the CCW. No 
data is transferred. If the device does 
not request data transfer, the operation 
proceeds to the normal ending point. 



If a zero byte count 
format-0 CCW which 
transfer in channel, 



is contained in a 
does not specify 
or if a zero byte 
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count is contained in a format-1 CCW 
that specifies data chaining or uas 
fetched while data chaining* a program- 
check condition is recognized, and the 
subchannel is made status-pending with 
combinations of primary, secondary, and 
alert status as a function of the state 
of the subchannel and the status 
received from the device. 

Note : For a description of the storage 
area associated with a CCW when indirect 
data addressing is invoked, see the 
section "CCW Indirect Data Addressing" 
later in this chapter. 



CHAINING 



When the channel subsystem has completed 
the transfer of information specified by 
a CCW, it can continue performing the 
start function by fetching a new CCW. 
Such fetching of a new CCW is called 
chaining, and the CCWs belonging to such 
a sequence are said to be chained. 

Chaining takes place between CCWs 
located in successive doubleword 
locations in storage. It proceeds in an 
ascending order of addresses; that is, 
the address of the new CCW is obtained 
by adding 8 to the address of the 
current CCW. Two chains of CCWs located 
in noncontiguous storage areas can be 



coupled for chaining purposes by a 
transfer-i n-channel command. All CCWs 
in a chain apply to the I/O device that 
is associated with the subchannel desig- 
nated by the original START SUBCHANNEL 
i nstructi on. 



Two types of 
provided: chaining 
of commands. Chaini 
the chain-data (CD) 
(CO flags in co 
suppress-length-i ndi 
the CCW. These flag 
to be taken by th 
upon the exhaustion 
and upon receipt of 
the device, as shown 
channel Chaining Act 
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The specification of chaining is effec- 
tively propagated through a transfei — 
i n-channel command. When, in the 
process of chaining, a transfer-in- 
channel command is fetched, the CCW 
designated by the transfei — i n-channel 
command is used for the type of chaining 
specified in the CCW preceding the 
transfer-i n-channel command. 

The CD and CC flags are ignored in a 
format-0 CCW specifying the transfei — 
i n-channel command. In a format-1 CCW 
specifying the transfei — i n-channel 
command, the CD and CC flags must be 
zeros; otherwise, a program-check condi- 
tion is recognized. 
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Flags in 

Current 

CCW 



CD 



CC 



SLI 



Action at the Subchannel upon Exhaustion of Count or 
Receipt of Channel End 



Immediate Operation 



Incorrect-Length- 
Suppression Mode 1 



CCW 
Count#0 



CCW 
Count=0 



Incorrect-Length- 
Indication Mode 



CCW 
Count#0 



CCW 
Count=0 



Nonimmediate Operation 



Count Exhausted 



CE Not 
Recei ved 



CE 
Received 



Count Not 
Exhausted 

and CE 
Received 



End, NIL 
End, NIL 
CC 
CC 

End, NIL 



End, NIL 
End, NIL 
CC 
CC 

PC 



End, IL 

End, NIL 

End, IL 
CC 

End, IL 



End, NIL 
End, NIL 
CC 
CC 

PC 



Stop, IL 
Stop, NIL 
Stop, IL 
Stop, CC 

CD 



End, NIL 
End, NIL 
CC 
CC 



End, IL 

End, NIL 

End, IL 
CC 

End, IL 



Explanation 



CC 
CD 

CE 

End 

IL 

NIL 

PC 

Stop 



The selected bit is ignored and may be either zero or one. 

These situations cannot validly occur. When data chaining is 
specified, the new CCW takes control of the operation after 
transferring the last byte of data designated by the current CCW, 
but before the next request for data or status transfer from the 
device. The new CCW (which cannot contain a count of zero unless 
a program-check condition is also recognized) is in control of 
the operation. 



The count field must contain a nonzero value when format-0 CCWs 
are specified; otherwise, the operation is terminated with a 
program-check condition. 

Command chaining is performed by the channel subsystem upon 
receipt of device end. 

The chain-data flag causes the channel subsystem to immediately 
fetch a new CCW for the same operation. The operation continues 
unless the CCW thus fetched has a count field of zero, in which 
case the operation is terminated with a program-check condition. 

Channel end from the device which indicates end of block. 

Operation is terminated. 

Incorrect length is indicated with the subsequent interruption 
condition generated at the subchannel. 

Incorrect length is not indicated with the subsequent 
interruption condition generated at the subchannel. 

These situations cannot validly occur. The channel subsystem 
recognizes a program-check condition when a CCW is fetched that 
has the chain-data flag set to one and a count field of zero. 

Device is signaled to terminate data transfer, but subchannel 
remains subchannel-active until channel end is received. 



Subchannel Chaining Action 



Programmi ng Note 



When bit 9 of word 1 of the ORB is one, 
unlimited fetching of chained CCWs by 
the channel subsystem is permitted. 
When prefetching is allowed by the ORB, 



no modification of the channel program 
should be performed after START SUBCHAN- 
NEL is executed and before the primary 
interruption condition for the operation 
has been received unless the subchannel 
is currently suspended and is not 
resume-pendi ng. 
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Data Chaining 



During data chaining* the new CCW 
fetched by the channel subsystem defines 
a new storage area for the original I/O 
operation. Execution of the operation 
at the I/O device is not affected. When 
all data designated by the current CCW 
has been transferred to main storage or 
to the device, data chaining causes the 
operation to continue, using the storage 
area designated by the new CCW. The 
contents of the command-code field of 
the new CCW are ignored, unless they 
specify transfer in channel. 
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If programming errors are detected in 
the new CCW or during its fetching, the 
error indication is generated, and the 
device is signaled to conclude the opei — 
at ion when it attempts to transfer data 
designated by the new CCW. If the 
device signals the channel-end condition 
before transferring any data designated 
by the new CCW, program check or 
protection check is indicated in the 
SCSW associated with the termination. 
The contents of the SCSW pertain to the 
new CCW unless the address of the new 
CCW is invalid, the location is 
protected against fetching, or program- 
ming errors are detected in an 
intervening transfei — in-chahnel command. 
A data address referring to a nonexist- 
ent or protected area causes an error 
indication only after the I/O device has 
attempted to transfer data to or from 
the invalid location. 

Data chaining during an input operation 
causes the new CCW to be fetched when 
all data designated by the current CCW 
has been placed in main storage. On an 
output operation, the channel subsystem 
may fetch the new CCW from main storage 
before data chaining occurs. Any 
programming errors in the prefetched 
CCW, however, do not affect the 
execution of the operation until all 
data designated by the current CCW has 
been transferred to the I/O device. If 
the device concludes the operation 
before all data designated by the 
current CCW has been transferred, the 
conditions associated with the 
prefetched CCW are not indicated to the 
program. Unlimited prefetching is 



allowed under the control of the 
prefetch bit specified in the ORB. (See 
the section "Operation-Request Block" 
earlier in this chapter.) When unlimit- 
ed prefetching is not allowed and an 
output operation is specified, only one 
CCW describing a data area may be 
prefetched. If a prefetched CCW speci- 
fies transfer in channel, only one more 
CCW may be fetched before the exhaustion 
of the current CCW. 



Programmi ng Notes 



1. If the ORB does not specify unlim- 
ited prefetching, no prefetching of 
CCWs is performed, except in the 
case of data chaining on an output 
operation where one CCW describing 
a data area may be prefetched at a 
time. 

If the ORB for the I/O operation 
specifies that prefetching is 
allowed, any number of CCWs may be 
prefetched and buffered in the 
channel subsystem. 

The same actions for signaling 
errors and terminating operations 
take place when unlimited prefetch- 
ing is allowed by the ORB as when 
it is not allowed. Therefore, 
neither the program nor the I/O 
device is aware of any differences 
whether or not prefetching of CCWs 
is being performed by the channel 
subsystem. 

When prefetching has been specified 
in the ORB, the result of modifica- 
tions to CCWs after START SUBCHAN- 
NEL has been executed or after 
self-describing channel programs 
have been used, is unpredictable. 
(See note 2 for the definition of 
self-describing channel programs.) 

2. Data chaining may be used to rear- 
range information as it is trans- 
ferred between main storage and an 
I/O device. Data chaining permits 
blocks of information to be trans- 
ferred to or from noncontiguous 
areas of storage, and, when used in 
conjunction with the skipping func- 
tion, data chaining allows the 
program to place in main storage 
specified portions of a block of 
data. 

When, during an input operation, 
the program specifies data chaining 
to a location in which data has 
been placed under the control of 
the current CCW, the channel 
subsystem, in fetching the next 
CCW, fetches the new contents of 
the location. This is true even if 
the location contains the last byte 
transferred under the control of 
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3. 



the current CCW. When a channel 
program data-chains to a CCW placed 
in storage by the CCW specifying 
data chaining/ the input block is 
said to be self-describing. A 
self-describing block contains one 
or more CCWs that designate storage 
locations and counts for subsequent 
data in the same input block. 

The use of self-describing blocks 
is equivalent to the use of 
unchecked data. An I/O data- 
transfer malfunction that affects 
validity of a block of information 
is signaled only at the completion 
of data transfer. The error condi- 
tion normally does not prematurely 
terminate or otherwise affect the 
execution of the operation. Thus, 
there is no assurance that a CCW 
read as data is valid until the 
operation is completed. If the CCW 
thus read is in error, use of the 
CCW in the current operation may 
cause subsequent data to be placed 
at wrong locations in main storage 
with resultant destruction of its 
contents, subject only to the 
control of the protection key and 
the address-limit-checking facil- 
ity, if used. 

When, during data chaining, a 
device transfers data by using the 
data-streaming feature, an overrun 
or chaini ng-check condition may be 
recognized when a small byte-count 
value is specified in the CCW. The 
minimum acceptable number of bytes 
that can be specified varies as a 
function of the system model and 
system activity. 



Command Chaining 



During command chaining, the new CCW 
fetched by the channel subsystem speci- 
fies a new I/O operation. The channel 
subsystem fetches the new CCW upon the 
receipt of the device-end signal for the 
current operation. If the new CCW does 
not specify an S flag and if no unusual 
conditions are detected, the channel 
subsystem initiates the new operation. 
The presence of the S flag or unusual 
conditions causes command chaining to be 
suppressed. When command chaining takes 
place, the completion of the current 
operation does not cause an I/O intei — 
ruption, and the count indicating the 
amount of data transferred during the 
current operation is not made available 
to the program. For 
ing data transfer, 
always applies to the 
at the device. 



operations involv- 

the new command 

next block of data 



Command chaining takes place and the new 
operation is initiated only if no unusu- 
al conditions have been detected in the 



current operation. In particular, the 
channel subsystem initiates a new I/O 
operation by command chaining upon 
receipt of a status byte containing only 
the following bit combinations: 
(1) device end, (2) device end and 
status modifier, (3) device end and 
channel end, and (4) device end, channel 
end, and status modifier. In the first 
two cases, channel end is signaled 
before device end, with all other status 
bits zeros. If a condition such as 
attention, unit check, unit exception, 
incorrect length, program check, or 
protection check has occurred, the 
sequence of operations is concluded, and 
the status associated with the current 
operation causes an interruption condi- 
tion to be generated. The new CCW in 
this case is not fetched. The 
incorrect-length condition does not 
suppress command chaining if the current 
CCW has the SLI flag set to one. 

An exception to sequential chaining of 
CCWs occurs when the I/O device presents 
the status-modifier condition with the 
device-end signal or channel-end and 
device-end signals. When command chain- 
ing is specified and no unusual 
conditions have been detected, or when 
command retry has been previously 
signaled and an immediate retry could 
not be performed, the combination of 
status-modifier and device-end bits 
causes the channel subsystem to alter 
the sequential execution of CCWs. If 
command chaining was specified, status 
modifier and device end cause the chan- 
nel subsystem to fetch and chain to the 
CCW whose main-storage address is 16 
higher than that of the CCW that speci- 
fied chaining. If command retry was 
previously signaled and immediate retry 
could not be performed, the status caus- 
es the channel subsystem to command 
chain to the CCW whose storage address 
is 8 higher than that of the CCW for 
which retry was initially signaled. 

When both command and data chaining are 
specified, the first CCW associated with 
the operation specifies the operation to 
be executed, and the last CCW specifies 
whether another operation follows. 



Programmi ng Note 



Command chaining makes it possible for 
the program to initiate transfer of 
multiple blocks of data by executing a 
single START SUBCHANNEL instruction. It 
also permits a subchannel to be set up 
for execution of other commands, such as 
positioning the disk-access mechanism, 
and for data-transfer operations without 
interference by the program at the end 
of each operation. Command chaining, in 
conjunction with the status-modifier 
condition, permits the channel subsystem 
to modify the normal sequence of opei — 
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No checking for invalid or protected 
data addresses takes place during skip- 
ping. 



Proqrammi ng Note 



Skipping, when combined with data chain- 
ing, permits the program to place in 
main storage specified portions of a 
block of information from an I/O device. 



PROGRAM-CONTROLLED INTERRUPTION 



The program-controlled-i nterrupti on 
(PCI) function permits the program to 
cause an I/O interruption during 
execution of an I/O operation. The 
function is controlled by the PCI flag 
of the CCW. Neither the value of the 
PCI flag nor the associated interruption 
request affects the execution of the 
current operation. 
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3. 



If the PCI flag is one in the first 
CCW associated with a start func- 
tion or a resume function, the 
subchannel becomes status-pending 
with intermediate status only after 
the command has been accepted. 

If the PCI flag is one in a CCW 
which has become current while data 
chaining, the subchannel becomes 
status-pending with intermediate 
status after all data designated by 
the preceding CCW has been trans- 
ferred. 

If the PCI flag is one in a CCW 
which has become current while 
command chaining, the subchannel 
becomes status-pending with intei — 
mediate status as that CCW becomes 
current. 
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An intermediate interruption may occur 
while the subchannel is subchannel-and- 
devi ce-acti ve with the operation speci- 
fied by the CCW causing the intermediate 
interruption condition or with the oper- 
ation specified by a CCW that has 
subsequently become current. If the 
intermediate interruption condition is 
not cleared prior to the conclusion of 
the operation or chain of operations, 
the condition is indicated together with 
the primary interruption condition at 
the conclusion of the operation or chain 
of operations. The intermediate intei — 
ruption condition may be cleared by TEST 
SUBCHANNEL while the subchannel is 
subchannel-acti ve. 
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to become current and have a PCI flag 
that is one, or the CCW-address field 
contains an address which is 8 higher 
than a CCW which has subsequently become 
current. Unless the SCSW also contains 
the primary-status bit set to one, the 
device-status field contains zeros, and 
the count is unpredictable. 

Subchannel-status conditions other than 
PCI may be indicated when the SCSW is 
stored. If the subchannel is not also 
status-pending with primary status, 
these conditions may or may not be indi- 
cated again. If the subchannel-status 
condition is detected while prefetching 
and the operation or chain of operations 
is concluded before the condition 
affects an operation, the condition is 
reset and is not indicated when the 
subchannel subsequently becomes status- 
pending with primary status. If the 
subchannel-status condition affects an 
operation, the condition is indicated 
when the subchannel becomes status- 
pending with primary status. 

If the program-controlled-i nterruption 
condition remains pending until the 
operation or chain of operations is 
concluded at the subchannel, a single 
interruption request exists. When TEST 
SUBCHANNEL is subsequently executed, the 
status-control field of the SCSW stored 
indicates both the primary interruption 
condition and the intermediate intei — 
ruption condition, and the PCI bit of 
the subchannel-status field is one. 

The value of the PCI flag is inspected 
in every CCW except for those CCWs that 
specify the transf er-in-channel command. 
The PCI flag is ignored during initial 
program loading. 



Programmi ng Notes 



The program-controlled interruption 
provides a means of alerting the 
program to the progress of chaining 
during an I/O operation. It 
permits programmed dynamic main- 
storage allocation. 

A CCW with a PCI flag that has a 
value of one may, if retried 
because of command retry, cause 
multiple PCI interruptions to 
occur. (See the section "Command 
Retry" later in this chapter.) 



CCW INDIRECT DATA ADDRESSING 



CCW indirect data addressing permits a 
single channel-command word to control 
the transfer of data that spans noncon- 
tiguous pages in real main storage. The 
use of CCW indirect data addressing also 



allows the program to designate data 
addresses above 16M for both format-0 
and format-1 CCWs. 

CCW indirect data addressing is speci- 
fied by a flag in the CCW which, when 
one, indicates that the data address is 
not used to directly address data. 
Instead, the address points to a list of 
words, called indirect-data-address 
words (IDAWs), each of which contains an 
absolute address designating a data area 
within a 2K-byte block of main storage. 

When the indirect-data-addressing bit in 
the CCW is one, the data-address field 
of the CCW designates the location of 
the first IDAW to be used for data 
transfer for the command. Additional 
IDAWs, if needed for completing the data 
transfer for the CCW, are in successive 
locations in storage. The number of 
IDAWs required for a CCW is determined 
by the count field of the CCW and by the 
data address in the initial IDAW. When, 
for example, the CCW count field speci- 
fies 4K bytes and the first IDAW 
designates a location in the middle of a 
2K-byte block, three IDAWs are required. 

Each IDAW is used for the transfer of up 
to 2K bytes. The IDAW designated by the 
CCW can designate any location. Data is 
then transferred, for read, write, 
control, sense ID, and sense commands, 
to or from successively higher storage 
locations or, for a read-backward 
command, to successively lower storage 
locations, until a 2K-byte block bounda- 
ry is reached. The control of data 
transfer is then passed to the next 
IDAW. The second and any subsequent 
IDAWs must designate, depending on the 
command, the first or last byte (for 
read backward) of a 2K-byte block. 
Thus, for read, write, control, sense 
ID, and sense commands, these IDAWs have 
zeros in bit positions 21-31. For a 
read-backward command, these IDAWs have 
ones in bit positions 21-31. 

Except for the unique restrictions on 
the designation of the data address by 
the IDAW, all other actions taken for 
the data address, such as for protected 
storage and invalid addresses, and the 
actions taken for data prefetching are 
the same as when indirect data address- 
ing is not used. 

IDAWs pertaining to the current CCW or a 
prefetched CCW may be prefetched. The 
number of IDAWs that can be prefetched 
cannot exceed that required to satisfy 
the count in the CCW that points to the 
IDAWs. An IDAW takes control of data 
transfer when the last byte has been 
transferred for the previous IDAW. The 
same actions take place as with data 
chaining regarding when an IDAW takes 
control of data transfer during an I/O 
operation. That is, when the count for 
the CCW has not reached zero, a new IDAW 
takes control of the data transfer when 
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the last byte has been transferred for 
the previous IDAW for that CCW, even in 
situations where (1) channel end, (2) 
channel end and device end, or (3) chan- 
nel end, device end, and status modifier 
are received prior to transfer of any 
data bytes pertaining to the new IDAW. 
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Access to the storage location 
designated by the address in the 
CCW is prohibited by protection, or 



Bit 
zero, 



of the first IDAW is not 



then, depending on the model, one of the 
following two actions is taken independ- 
ent of the setting of the skip flag: 



1. 



2. 



The above conditions are checked 
before initiating the operation at 
the device. If any of these condi- 
tions is recognized, initiation of 
the I/O operation does not occur, 
and the subchannel i s made status- 
pending with primary, secondary, 
and alert status. 



The format of the IDAW and the signif- 
icance of its fields are as follows: 
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Data Address 



31 

Bit is reserved for future use and 
must be zero. Otherwise, a program- 
check condition may be recognized, as 
described below. 

Bits 1-31 designate the location of the 
first byte to be used in the data trans- 
fer. In the first IDAW for a CCW, any 
location can be designated. For subse- 
quent IDAWs, depending on the command, 
either the first or the last location of 
a 2K-byte block located on a 2K-byte 
boundary must' be designated. For read, 
write, control, and sense commands, the 
location at the beginning of the block 
must be designated; that is, bits 21-31 
of the IDAW must be zeros. For a read- 
backward command, the location at the 
end of the block must be designated; 
that is, bits 21-31 of the IDAW must be 
all ones. Improper data-address desig- 
nation causes the program-check 
condition to be generated and the opera- 
tion to be terminated. 

When the IDAW flag of the CCW is set to 
one and any of the following conditions 
occurs: 

1. The address in the CCW does not 
designate the first IDAW on an 
integral word boundary, 

2. The address in the CCW designated a 
storage location which is not 
avai lable, 



SUSPENSION OF CHANNEL-PROGRAM EXECUTION 



The suspend function, when used in 
conjunction with RESUME SUBCHANNEL, 
provides the program with a means to 
stop and restart the execution of a 
channel program. The initiation of the 
suspend function is controlled by the 
setting of the suspend-control bit in 
the ORB (bit <t of word 1). The suspend 
function is signaled when suspend 
control has been specified for the 
subchannel in the ORB and a CCW contain- 
ing a valid S flag set to one becomes 
the current CCW. The flag can be indi- 
cated either in the first CCW of the 
channel program or in a CCW fetched 
while command chaining. The S flag is 
not valid and causes a program-check 
condition to be recognized if (1) the 
ORB contains the suspend-control bit set 
to zero, or (2) the CCW is fetched while 
data chaining (see the section "Data 
Chaining" earlier in this chapter, 
concerning the handling of programming 
errors detected during data chaining). 

Upon recognition of the suspend 
function, suspension of channel-program 
execution occurs when the CCW becomes 
current (see the section "Channel- 
Command Word" earlier in this chapter, 
for a definition of when a CCW becomes 
current). If suspension occurs during 
command chaining, the device is signaled 
that command chaining is no longer in 
effect. 
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RESUME SUBCHANNEL signals that the CCW 
which caused channel-program suspension 
may have been modified, that the CCW 
must be refetched, and that the contents 
of the CCW must be examined to determine 
the settings of the flags. If the S 
flag is one, execution of that CCW does 
not occur. If the CCW is valid and the 
S flag in the CCW is zero, execution is 
initiated (see the section "RESUME 
SUBCHANNEL" in Chapter 14, "I/O 
Instructions" and the section "Start 
Function and Resume Function" earlier in 
this chapter). 

When a valid CCW that contains a valid S 
flag becomes the current CCW during 
command chaining and the resume-pending 
condition is not recognized, the suspend 
function is performed and causes the 
following actions to occur in the order 
gi ven: 



The device 
chain of 
concluded. 



is signaled that the 
operations has been 



Channel-program execution is sus- 
pended at the subchannel; all 
prefetched IDAWs, CCWs, and data 
&re discarded; and the subchannel 
is set up such that the resume 
function can be performed when the 
subchannel is next recognized to be 
resume-pendi ng. 

If the measurement-block-update 
mode is active and the subchannel 
is enabled for the mode, the 
accrued values of the measurement 
data, including the start- 
subchannel and sample count, are 
added to the accumulated values in 
the measurement block for the 
subchannel. The start-subchannel 
count is the only measurement data 
which is updated in the measurement 
block if the channel-subsystem- 
timing facility is not available 
for the subchannel. (See the 
section "Channel-Subsystem Monitoi — 
ing" in Chapter 17, "I/O Support 
Functions," for more information.) 



4. 



The subchannel 
suspended state. 



is placed in the 



5. If the subchannel is not resume- 
pending at this point, the interme- 
diate interruption condition due to 
suspension is recognized if the 
suppr ess- suspended- i nterruption bit 
of the ORB is zero; otherwise, the 
resume function is performed. 

When a valid CCW that contains a valid S 
flag becomes the current CCW during 
command chaining and the resume-pending 
condition is recognized, the resume 
function is performed instead of the 
suspend function. 



pending condition is not recognized, the 
suspend function is performed and causes 
the following actions to occur in the 
order given: 

1. Channel-program execution is 
suspended prior to selection of the 
devi ce. 

2. The subchannel is set up such that 
the resume function can be 
performed when the subchannel i s 
next recognized to be resume- 
pending. 

3. If the measurement-block-update 
mode is active and the subchannel 
is enabled for the mode, the 
SSCH+RSCH count is incremented and 
the accrued function-pending time 
(a function of the setting of the 
timing-facility bit) is added to 
the accumulated value in the meas- 
urement block for the subchannel. 



4. 



The subchannel 
suspended state. 



is placed in the 



If the subchannel i s not resume- 
pending at this point, the subchan- 
nel is made status-pending with 
intermediate status due to suspen- 
sion if the suppress-suspended- 
interruption-control bit of the ORB 
is zero; otherwise, the resume 
function is performed. 



of a channel program 
flag and the resume- 
is recognized, the 
performed instead of 



When the first CCW 
contains a valid S 



of a channel 
flag and the 



program 
resume- 



When the first CCW 
contains a valid S 
pending condition 
resume function is 
the suspend function 



Programmi ng Notes 



The execution of MODIFY SUBCHANNEL 
and START SUBCHANNEL completes with 
condition code 2 set if the desig- 
nated subchannel is suspended. The 
start function is indicated at the 
subchannel while the subchannel is 
in the suspended state. 

In certain situations, normal 
resumption of the execution of a 
channel program which has been 
suspended may not be desired. 
Normal termination of the suspended 
channel-program execution may be 
accomplished by: 

a. Executing HALT SUBCHANNEL 
designating the subchannel 

b. Modifying the CCWs in storage 
such that when channel-program 
execution is resumed, the 
command transferred to the 
device is a control command 
with all modifier bits speci- 
fied as zeros (no-operation) 
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and with the chai n-co^mand flag 
specified as zero; and then 
executing RESUME SUBCHANNEL. 

If the suspended interruption is 
suppressed, the N condition and 
DCTI values applicable to the 
preceding subchannel-active period 
are not made available to the 
program. The execution of RESUME 
SUBCHANNEL when the subchannel is 
in the suspended state causes 
path-not-operational conditions and 
the N condition to be reset to 
zeros. Path-not-operational condi- 
tions and the N condition are not 
reset when RESUME SUBCHANNEL is 
executed and the designated 



subchannel 
state. 



is not in the suspended 



COMMANDS 



The figure "Command 
command codes for the 
indicates which flag 
each command. Except 
specifying transfer 
flags are ignored fo 
which they are not d 
are reserved in a fo 
ing transfer in cha 
zeros. 



Codes* 1 lists the 

seven commands and 

s are defined for 

for a format-1 CCW 

in channel, the 

r all commands for 

efined. The flags 

rmat-1 CCW specify- 

nnel and must be 



Name 


Code 


Flags 


Wri te 




MMMM MM 01 


CD CC SLI 


PCI 


IDA S 


Read 




MMMM MM 10 


CD CC SLI 


SKIP PCI 


IDA S 


Read backward 


MMMM 1100 


CD CC SLI 


SKIP PCI 


IDA S 


Control 


MMMM MM 11 


CD CC SLI 


PCI 


IDA S 


Sense 




MMMM 0100 


CD CC SLI 


SKIP PCI 


IDA S 


Sense 


ID 


1110 0100 


CD CC SLI 


SKIP PCI 


IDA S 


Transfer in channel 


XXXX 1000 


(See note 


below) 




Explanati on: 


i 






CC 


Chain commanc 


CD 


Chain data 






IDA 


Indirect data addressing 






M 


Modifier bit 






PCI 


Program-controlled interruption 






S 


Suspend 






SKIP 


Skip 






SLI 


Suppress-length indication 






X 


Ignored in a format-0 CCW; must 


ae zero in a 




format-1 CCW 






Note: 


Flags are ignored in a format-0 
channel CCW and must be zeros in 


transfer- 
a format 


in- 
-1 






transfei — in-channel CCW. 







Command Codes 
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All flags have individual si gni f i cance, 
except that the CC and SLI flags are 
ignored when the CD flag is set to one. 
The presence of the SLI flag is ignored 
for immediate operations involving 
format-0 CCWs, in which case the 
incorrect-length indication is 
suppressed regardless of the setting of 
the flag. The incorrect-length indi- 
cation may be suppressed for immediate 
operations when executing a format-1 
CCW, depending on the incorrect-length- 
suppression mode. The PCI flag is 
ignored during initial program loading. 
All flags, except the PCI flag, qtq 
ignored when the S flag is one. 



Each command 
i llustrati on 



is described below, 
of its CCW formats. 



with an 



Wri te 
Format 



MMMMMM01 



Data Address 



31 



c 


C 


S 




P 


I 










D 


C 


L 
I 


/ 


c 

I 


D 
A 


S 





//////// 


Count 



32 



35 



40 



48 



63 



Format 1 



Programmi ng Notes 



1. A malfunction that affects the 
validity of data transferred in an 
I/O operation is signaled at the 
end of the operation by means of 
unit check or channel-data check, 
depending on whether the device 
(control unit) or the channel 
subsystem detected the error. In 
order to make use of the checking 
facilities provided in the system, 
data read in an input operation 
should not be used until the end of 
the operation has been reached and 
the validity of the data has been 
checked. Similarly, on writing, 
the copy of data in main storage 
should not be destroyed until the 
program has verified that no 
malfunction affecting the transfer 
and recording of data was detected. 

2. An error condition may be recog- 
nized and the I/O operation termi- 
nated when 256 or more chained 
commands are executed with a device 
and none of the executed commands 
result in the transfer of any data. 
When this condition is recognized, 
program check is indicated. 



All CCWs that require 
of incorrect-length 
must use the SLI flag. 



suppressi on 
i ndi cati ons 





C 


C 


S 




P 


I 








MMMMMM01 


D 


C 


L 
I 


/ 


C 
I 


D 
A 


S 





Count 



11 



16 



31 




A write operation is initiated at the 
I/O device, and the subchannel is set up 
to transfer data from main storage to 
the I/O device. Data is fetched from 
storage in an ascending order of 
addresses, starting with the location 
designated by the CCW. 

A CCW used in a write operation is 
inspected for the CD, CC, SLI, PCI, IDA, 
and S flags. The setting of the skip 
flag is ignored. Bit positions 0-5 of 
the CCW contain modifier bits. 



Programmi ng Note 



When writing on devices for which the 
block length is not defined, such as a 
magnetic-tape unit or an inquiry 
station, the amount of data written is 
controlled only by the count in the CCW. 
Every operation terminated under count 
control causes the incorrect-length 
indication, unless the indication is 
suppressed by the SLI flag. 
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Read 
Format 



Read Backward 



Format 



MMMMMM10 



Data Address 



31 



MMMM1100 



Data Address 



31 









S 














c 


C 


s 


K 


P 


I 










D 


c 


L 
I 


I 
P 


C 

I 


D 
A 


S 





//////// 


Count 



32 



40 



48 



63 









S 














c 


C 


S 


K 


P 


I 










D 


C 


L 
I 


I 
P 


C 
I 


D 
A 


S 





//////// 


Count 



32 



40 



48 



63 



Format 1 



Format 1 











S 














C 


C 


S 


K 


P 


I 








MMMMMM10 


D 


C 


L 
I 


I 
P 


C 
I 


D 

A 


S 





Count 



16 



31 











S 














C 


C 


S 


K 


P 


I 








MMMM1100 


D 


C 


L 
I 


I 
P 


C 
I 


D 
A 


S 





Count 



16 



31 




A read operation is initiated at the I/O 
device, and the subchannel is set up to 
transfer data from the device to main 
storage. For devices such as magnetic- 
tape units, disk storage, and card 
equipment, the bytes of data within a 
block are provided in the same sequence 
as written by means of a write command. 
Data is placed in storage in an ascend- 
ing order of addresses, starting with 
the location designated by the CCW. 

A read command code containing zeros for 
the six modifier bits is also called an 
initial-read command. This command is 
used by those devices that can perform 
the initial-program-loading function if 
the command is the first to be executed 
after a system-reset signal is received. 

A CCUI used in a read operation is 
inspected for every one of the seven 
flags — CD, CC, SLI, SKIP, PCI, IDA, 
and S. Bit positions 0-5 of the CCW 
contain modifier bits. 




A read-backward operation is initiated 
at the I/O device, and the subchannel is 
set up to transfer data from the device 
to main storage. On magnetic-tape 
units, read backward causes reading to 
be performed with the tape moving back- 
ward. The bytes of data within a block 
are sent in a sequence opposite to that 
on writing. The bytes are placed in 
storage in a descending order of 
addresses, starting with the location 
designated by the CCW. The bits within 
an eight-bit byte are in the same order 
as sent to the device on writing. 

A CCW used in a read-backward operation 
is inspected for every one of the seven 
flags — CD, CC, SLI, SKIP, PCI, IDA, 
and S. Bit positions 0-3 of the CCW 
contain modifier bits. 
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Control 
Format 



MMMMMM1 1 



Data Address 



31 



c 


C 


s 




P 


I 










D 


C 


L 
I 


/ 


c 
I 


D 
A 


S 





//////// 


Count 



32 



35 



Format 1 



40 



48 



63 



a no-operation . If the command is 
accepted, the no-operation order causes 
the addressed device to respond with 
channel end and device end without caus- 
ing any action at the device. The order 
can be executed as an immediate opera- 
tion* or the device can delay the status 
until after the initiation sequence is 
completed. Other operations that can be 
initiated by means of the control 
command depend on the type of I/O 
device. These operations and their 
codes are specified in the System 
Library publication for the device. 

A CCW used in a control operation is 
inspected for the CD, CC, SLI, PCI, IDA, 
and S flags. The setting of the skip 
flag is ignored. Bit positions 0-5 of 
the CCW contain modifier bits. 





C 


C 


S 




P 


I 








MMMMMM11 


D 


C 


L 
I 


/ 


C 
I 


D 
A 


S 





Count 



11 



16 



31 




ascending order of 
with the address 
CCW. A control 

to initiate at the 



A control operation is initiated at the 
I/O device, and the subchannel is set up 
to transfer data from main storage to 
the device. The device interprets the 
data as control information. The 
control information, if any, is fetched 
from storage in an 
addresses, starting 
designated in the 
command may be used 
device an I/O operation not involving 
transfer of data, such as backspacing or 
rewinding magnetic tape or positioning a 
disk-access mechanism. 

For many control functions, the entire 
operation is specified by the modifier 
bits in the command code, and the func- 
tion is performed over the channel path 
as an immediate operation (see the 
section "Immediate Conclusion of I/O 
Operations" later in this chapter). If 
the command code does not specify the 
entire control function, the data- 
address field of the CCW designates the 
location containing the required addi- 
tional information. This control 
information may include an order code 
further specifying the operation to be 
executed or an address, such as the disk 
address for the seek function, and is 
transferred in response to requests by 
the device. 

A control-command code containing zeros 
for the six modifier bits is defined as 



Programmi ng Notes 



Since a format-1 CCW with a count 
of zero is valid, the program can 
use the CCW count field to specify 
that no data be transferred to the 
I/O device. If the device requests 
a data transfer, the device is 
signaled to terminate data 
transfer. If the SLI and chain- 
command flags are also specified, 
and no unusual conditions are 
encountered subsequent to signaling 
the device to terminate data trans- 
fer, then the new operation is 
initiated upon receipt of device 
end from the device. 

If the subchannel is in the 
i ncorrect-length-suppressi on mode, 
if the chain-data flag in the 
current CCW is zero, and if the 
operation is executed as an immedi- 
ate operation, then incorrect 
length is not indicated, regardless 
of the setting of the SLI flag. 

If the subchannel is in the 
incorrect-length-i ndi cati on mode, 
if the chain-data flag in the 
current CCW is zero, and if the 
operation is executed as an immedi- 
ate operation, then incorrect 
length is indicated if the count 
field of the current CCW specifies 
a nonzero value, unless suppressed 
by the SLI flag of the CCW; incor- 
rect length is not indicated, 
however, if the count field of the 
CCW specifies a value of zero. 

If a new CCW that has a count field 
of zero is fetched during data 
chaining or if a CCW is fetched 
with the chain-data flag set to one 
and a count field of zero, then a 
program-check condition is recog- 
nized by the channel subsystem. 
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Sense 
Format 



MMMM0100 



Data Address 



31 









S 














c 


C 


S 


K 


P 


I 










D 


C 


L 
I 


I 
P 


C 
I 


D 
A 


S 





//////// 


Count 



32 



Format 1 



40 



48 



63 











S 














C 


C 


s 


K 


P 


I 








MMMM010 


D 


c 


L 
I 


I 
P 


C 

I 


D 
A 


S 





Count 



16 



31 




A sense operation is initiated at the 
I/O device, and the subchannel is set up 
to transfer sense data from the device 
to storage. The data is placed in stoi — 
age in an ascending order of addresses, 
starting with the location designated by 
the CCW. 

The basic sense command is specified 
when the modifier bits are all zeros. 
Data transferred during a basic sense 
operation provides information concern- 
ing both unusual conditions detected by 
the device and the status of the device. 
The information provided by the basic 
sense command is more detailed than that 
supplied by the device-status byte and 
may describe reasons for the unit-check 
indication. It may also indicate, for 
example, if the device is in the 
not-ready state, if the tape unit is in 
the file-protected state, or if magnetic 
tape is positioned beyond the end-of- 
tape mark. 

The first six bits of the first sense- 
data byte (sense byte 0) are common to 
all I/O devices. The six bits, when set 
to ones, designate the following: 



Bit 


Desi gnati on 



1 
2 
3 
4 
5 


Command reject 
Intervention required 
Bus-out check 
Equipment check 
Data check 
Overrun 



The following 
first six bits: 



is the meaning of the 



Command Reject : The device has 
detected a programming error. A 
command has been received which the 
device is not designed to execute, 
such as read backward transferred 
to a direct-access-storage device, 
or which the device cannot execute 
because of its present state, such 
as write transferred to a file- 
protected tape unit. The program 
may have required use of an 
optional feature or may have speci- 
fied invalid control data. An 
example of invalid control data 
which is treated as an extension of 
the command is an invalid seek 
argument that i s transferred to a 
direct-access-storage device. 
Command reject is also indicated 
when an invalid sequence of 
commands is recognized by the 
device, such as write to a direct- 
access-storage device without 
previously designating the data 
block. 



Interventi on Regui red : 



operation could not b 
because of a condition 
some type of intervent 
device. This bit set t 
cates conditions such a 
hopper in a card punch o 
ter being out of paper, 
set to one when the 
device is in the not-r 
is in test mode, or on s 
units when the devic 
provided on the control 



The last 
e executed 

requi ri ng 
i on at the 
o one indi- 
s an empty 
r the prin- 
It is also 

addressed 
eady state, 
ome control 
e is not 
uni t . 



Bus-Out Check : The device has 
received a data byte or a command 
code with invalid CBC over the 
channel path. During writing, 
bus-out check indicates that incoi — 
rect data may have been recorded at 
the device, but the condition does 
not cause the operation to be 
terminated prematurely unless the 
operation is such that an error 
precludes meaningful continuation 
of the operation. Invalid CBC 
detected on the command code or 
control information causes the 
operation to be immediately termi- 
nated and suppresses checking for 
command-reject and intervention- 
required conditions. 
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Equipment Check : During the last 
operation, the device has detected 
equipment malfunctioning, such as 
an invalid card-hole count or a 
printei — buffer parity error. 

Data Check : The device has 
detected a data error other than 
one included in bus-out check. 
Data check identifies errors asso- 
ciated with the recording medium 
and includes conditions such as 
reading an invalid card code or 
detecting invalid parity on data 
recorded on magnetic tape. 

On an input operation, data check 
indicates that incorrect data may 
have been placed in main storage. 
The device forces correct parity on 
data sent to the channel subsystem. 
On writing, this condition indi- 
cates that incorrect data may have 
been recorded at the device. 
Unless the operation i s of a type 
where the error precludes meaning- 
ful continuation, data errors on 
reading and writing do not cause 
the operation to be terminated 
prematurely. 

Overrun : The overrun condition 
occurs when the channel subsystem 
fails to respond to the control 
unit in the anticipated time intei — 
val to a request for service from 
the I/O device. When the total 
activity initiated by the program 
exceeds the capability of the chan- 
nel subsystem, an overrun may occur 
when data is transferred to or from 
a control unit that is either using 
the data-streaming feature or is 
not buffered. An overrun condition 
also may occur when the device 
receives the new command too late 
during command chaining. The 
data-streaming feature is described 
in the System Library publication 
IBM Svstem/360 and Svstem/370 I/O 
Interface Channel to Control Uni t 
OEMI , GA22-6974. Refer to the 
System Library publication for the 
device for information concerning 
the availability of the data- 
streaming feature for that device. 



All informa 
of the dev 
the first s 
f ollowi ng 
i nformation 
i nf ormati on 
sense bytes 
the basic s 
hex) may ex 
ed. The n 
sense bytes 
sense byte 
devi ce. 



tion sign 
ice normal 
ense byte, 
those use 
may c 
, and th 

provi ded 
ense comma 
tend up to 
umber and 

extendi n 
depend o 



ificant to the use 
ly is provided in 
Any bit positions 
d for programming 
ontain diagnostic 
e total number of 

by the device for 
nd (command code 04 

32 bytes, as need- 
the meaning of the 
g beyond the first 
n the type of I/O 



cannot cause the 
i nterventi on-requi red, 
overrun bit to be set 
control unit detects 
malfunction, or invalid 
sense-command code, the 
or bus-out-check bit is 
unit check is indicated 
status byte. 



command- reject, 

data-check, or 

to one. If the 

an equipment 

parity on the 

equi pment-check 

set to one, and 

in the device- 



Devices that can provide special diag- 
nostic sense information or that can be 
instructed to perform other special 
functions by use of the sense command 
may define modifier bits for the control 
of these functions. The special sense 
operations may be initiated by a unique 
combination of modifier bits (see the 
section "Sense ID" later in this 
chapter), or a group of codes may speci- 
fy the same function. Any remaining 
sense-command codes may be considered 
invalid, thus causing the unit-check 
indication, or may cause the same action 



as the basic sense 
the type of device. 



command, depending on 



The sense information pertaining to the 
last I/O operation or device action may 
be reset any time after the completion 
of a sense command addressed to that 
device. Except for the no-operation 
command, any other command addressed to 
the device may be allowed to reset the 
sense information, provided that the 
busy bit is not included in the initial 
status. The sense information may also 
be changed as a result of asynchronous 
actions, for example, when the device 
changes from the not-ready to the ready 
state. 

A CCUI used in a sense operation is 
inspected for every one of the seven 
flags — CD, CC, SLI, SKIP, PCI, IDA, 
and S. Bit positions 0-3 of the CCW 
contain modifier bits. 



Sense ID 
Format 



11100100 



Data Address 



31 









S 
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//////// 


Count 



32 



40 



48 



63 



The basic sense command initiates a 
sense operation on all devices and 
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Format 1 
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Count 



16 



31 




Execution of the sense-ID command 
proceeds exactly as for a read command, 
except that the data is obtained from 
sensing indicators rather than from a 
record source. The data transferred can 
be up to seven bytes in length. 

The control unit and I/O device may 
properly execute the sense-ID command, 
may execute the command as the basic 
sense command, or may reject the sense- 
ID command with unit-check status, 
depending on the control-unit and 1/0- 
device model. 

The sense-ID command does not initiate 
any operations other than the sensing of 
the type/model number. If the control 
unit and I/O device are available, then 
the sense-ID command is executed even if 
the I/O device is absent or not ready. 

Basic sense data may be reset as a 
result of executing the sense-ID 
command. 



Bytes Contents 

FF hex 

1,2 Control-unit type number 

3 Control-unit model number 

4,5 I/0-device type number 

6 I/0-device model number 

All unused sense bytes are set to zeros. 

Bytes 1 and 2 contain the foui — decimal- 
digit control-unit type number that 
corresponds directly with the control- 
unit type number attached to the control 
unit. 

Byte 3 contains the control-unit model 
number, if applicable. If not appli- 
cable, byte 3 is a byte of all zeros. 

Bytes 4 and 5 contain the foui — decimal- 
digit I/0-device type number that corre- 
sponds directly with the I/Q-device type 
number attached to the I/O device. 



Byte 6 contains the I/0-device model 
number, if applicable. If not applica- 
ble, byte 6 is a byte of all zeros. 

Whenever a control unit is not separate- 
ly addressable from the attached I/O 
device or I/O devices, the response to 
the sense-ID command is a concatenation 
of the control-unit type number and the 
I/0-device type number. 

If a control unit can be addressed sepa- 
rately from the attached I/O device or 
I/O devices, then the response to the 
sense-ID command depends on the unit 
addressed. If the control unit is 
addressed, the response to the sense-ID 
command is as follows: 

Bvtes Contents 

FF hex 

1,2 Control-unit type number 

3 Control-unit model number 

The response consists of the control- 
unit type and model number, with normal 
ending status presented after byte 3. 

If the I/O device is addressed, the 
response to the sense-ID command is as 
follows: 

Bvtes Contents 

FF hex 

1,2 I/0-device type number 

3 I/0-device model number 

The response consists of the I/0-device 
type and model number, with normal 
ending status presented after byte 3. 

For communication controllers utilizing 
indirect addressing to end devices, and 
for cases where the control unit and 
device are not distinct, the sense data 
source is the same as if a control unit 
were being addressed. 



A CCU used in a sense-ID 
inspected for every flag -■ 
SKIP, PCI, IDA, and S. 



Transfer in Channel 



operation is 
CD, CC, SLI, 



Format 



//// 


1000 


CCU Address 



31 



///////////////////////////////// 



32 



63 
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Format 1 



00001000 000000000000000000000000 



31 



CCW Address 



32 



63 



The next CCW i s fetched from the 
location in absolute main storage desig- 
nated by the data-address field of the 
CCW specifying transfer in channel. The 
transfei — in-channel command does not 
initiate any I/O operation, and the I/O 
device is not signaled of the execution 
of the command. The purpose of the 
transfei — in-channel command is to 
provide chaining between CCWs not 
located in adjacent doubleword locations 
in an ascending order of addresses. The 
command can occur in both data and 
command chaining. 

Bits 29-31 (format 0) or bits 61-63 
(format 1) of a CCW that specifies the 
transfei — in-channel command must be 
zeros, designating a CCW on a doubleword 
boundary. Furthermore, a CCW specifying 
transfer in channel may not be fetched 
from a location designated by an imme- 
diately preceding transfer in channel. 
When either of these errors is detected 
or when an invalid address is designated 
in the transfer-i n-channel command, the 
program-check condition is generated. 
When a CCW which specifies the 
transfei — in-channel command designates a 
CCW at a location protected against 
fetching, the protection-check condition 
is generated. Detection of these errors 
during data chaining causes the opera- 
tion at the I/O device to be terminated 
and an interruption condition to be 
generated, whereas during command chain- 
ing it causes only an interruption 
condition to be generated. 

The contents of the second half of the 
format-0 CCW, bit positions 32-63, are 
ignored. Similarly, the contents of bit 
positions 0-3 of the format-0 CCW are 
ignored. 

Bit positions 0-3 and 8-32 of the 
format-1 CCW must contain zeros; other- 
wise, a program-check condition is 
generated. 



COMMAND RETRY 



The channel subsystem has the capability 
to perform command retry, a procedure 
that causes a command to be retried 
without requiring an I/O interruption. 
This retry is initiated by the control 
unit presenting either of two status-bit 
combinations by means of a special 



sequence. When immediate retry can be 
performed, it presents a channel-end, 
unit-check, and status-modifier status- 
bit combination, together with device 
end. When immediate retry cannot be 
performed, the presentation of device 
end is delayed until the control unit is 
prepared. When device end is presented 
alone, the previous command is trans- 
ferred again. If device end is 
accompanied by status modifier, command 
retry is not performed, and the channel 
subsystem command-chains to the CCW 
following the one for which command 
retry was signaled (see the section 
"Status Modifier" in Chapter 16, "I/O 
Interruptions"). When the channel 
subsystem is not capable of performing 
command retry due to an error condition, 
or when any status bit other than device 
end or device end and status modifier 
accompanies the requested command-retry 
initiation, the retry is suppressed, and 
the subchannel becomes status-pending. 
The SCSW stored by TEST SUBCHANNEL 
contains the channel-end, unit-check, 
and status-modifier status indications, 
along with any other appropriate status. 



Proqrammi ng Note 



The following possible results of a 
command retry must be anticipated by the 
program: 

1. A CCW containing a PCI may, if 
retried because of command retry, 
cause multiple PCI interruptions to 
occur. 

2. If a CCW used in an operation is 
changed before that operation has 
been successfully completed, the 
results are unpredictable. 



CONCLUDING I/O OPERATIONS DURING INITI- 
ATION 



After the designated subchannel has been 
determined to be i n a state such that 
START SUBCHANNEL can be executed, 
certain tests are performed on the 
validity of the information specified by 
the program and on the logical avail- 
ability of the associated device. This 
testing occurs during or subsequent to 
the execution of START SUBCHANNEL and 
during command chaining and command 
retry. 

A data-transfer operation is initiated 
at the subchannel and device only when 
no programming or equipment errors sre 
detected by the channel subsystem and 
when the device responds with zero 
status during the initiation sequence. 
When the channel subsystem detects or 
the device signals any unusual condition 



15-42 370-XA Principles of Operation 



during the initiation of an I/O opera- 
tion> the command is said to be not 
accepted. In this case, the subchannel 
becomes status-pending with primary, 
secondary, and alert status. Deferred 
condition code 1 is set, and the start- 
pending bit remains set to one. 

Conditions that preclude the initiation 
of an I/O operation are detailed in the 
SCSW stored by TEST SUBCHANNEL. In this 
situation, the device is not started, no 
interruption conditions are generated 
subsequent to TEST SUBCHANNEL, and the 
subchannel is idle. The device is imme- 
diately available for the initiation of 
another operation, provided the command 
was not rejected because of the busy or 
not-operational condition. 

When an unusual condition causes a 
command to be not accepted during the 
initiation of an I/O operation by 
command chaining or command retry, an 
interruption condition is generated, and 
the subchannel becomes status-pending 
with combinations of primary, secondary, 
as a function of the 
by the device. The 
the condition remains 
until cleared by TEST 
conditions are indi- 
cated to the program by means of the 
corresponding status bits in the SCSW. 
A path-not-operational condition recog- 
nized during command chaining is 
signaled to the program by means of an 
interface-control-check indication. The 
new I/O operation at the device is not 
started. 



and alert status 
status signaled 
status describing 
at the subchannel 
SUBCHANNEL. The 



START SUBCHANNEL is execu 
of its associated device, 
program-specified informa 
availability and unit s 
most error conditions 
subsequent to the execu 
SUBCHANNEL. When any 
detected that preclude 
the start function, a 
condition is generated 
subsystem and placed at 
causing it to become stat 



ted independent 
Tests on most 
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tatus, and on 
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tion of START 
conditions are 
performance of 
n interruption 
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specified in the ORB and 
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ate operation is the fir 
the channel program, def 
code 1 i s set and accompa 
indications. If intermed 
indicated, the indication 
as a result of the CCW 
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er in this chapter). 
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If the immedi- 
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IMMEDIATE CONCLUSION OF I/O OPERATIONS 



Whenever immediate completion of an I/O 
operation is signaled, no data has been 
transferred to or from the device, and 
the data address in the CCW is not 
checked for validity. If the subchannel 
is in the incorrect-length-suppression 
mode, incorrect length is not indicated 
to the program, and command chaining is 
performed when specified. If the 
subchannel is in the incorrect-length- 
indication mode, incorrect length and 
command chaining are under control of 
the SLI and chain-command flags. The 
conditions which cause the incorrect- 
length indication to be suppressed are 
summarized in the figure "Subchannel 
Chaining Action" in the section "Chain- 
ing" earlier in this chapter. 



Programming Note 



I/O operations for which the entire 
operation is specified in the command 
code may be executed as immediate oper- 
ations. Whether the command is executed 
as an immediate operation depends on the 
operation and type of device. 



During the initiation of an I/O opera- 
tion, the device can accept the command 
and signal the channel-end condition 
immediately upon receipt of the command 
code. An I/O operation causing the 
channel-end condition to be signaled 
during the initiation sequence is called 
an immediate operati on . Status genei — 
ated by the device for the immediate 
command, when command chaining is not 
specified and command retry is not 
signaled, causes the subchannel to 
become status-pending with combinations 
of primary, secondary, intermediate, and 
alert status as a result of information 



CONCLUDING I/O OPERATIONS DURING DATA 
TRANSFER 



When the subchannel has been passed the 
contents of an ORB, the subchannel is 
said to be start-pending. When the I/O 
operation has been initiated and the 
command has been accepted, the subchan- 
nel becomes subchannel-and-devi ce active 
and remains in that state unless (1) the 
channel subsystem detects an equipment 
malfunction, (2) the operation is 
concluded by execution of CLEAR SUBCHAN- 
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NEL or HALT SUBCHANNEL, or (3) status 
which causes a primary interruption 
condition to be recognized (usually 
channel end) is accepted from the 
device. When command chaining and 
command retry are not specified or when 
chaining is suppressed because of unusu- 
al conditions, the status that is 
recognized as primary status causes the 
operation at the subchannel to be 
concluded and an interruption condition 
to be generated. The status bits in the 
associated SCSW indicate primary status 
and the unusual conditions, if any. The 
device can present status that is recog- 
nized as primary status at any time 
after the initiation of the I/O opera- 
tion, and the presentation of status may 
occur before any data has been trans- 
ferred. 

For operations not involving data trans- 
fer, the device normally controls the 
timing of the channel-end condition. 
The duration of data-transfer operations 
may be variable and may be controlled by 
the device or the channel subsystem. 

Excluding equipment errors, and the 
execution of the CLEAR SUBCHANNEL, HALT 
SUBCHANNEL, and RESET CHANNEL PATH 
instructions, the channel subsystem 
signals the device to conclude execution 
of an I/O operation during data transfer 
whenever any of the following conditions 
occurs: 



end by blocking of data. On certain 
operations for which blocks are defined 
(such as reading on magnetic tape), the 
device does not present channel-end 
status until the end of the block is 
reached, regardless of whether the 
device has been previously signaled to 
conclude data transfer. 

Checking for the validity of the data 
address is performed only as data is 
transferred to or from main storage. 
When the initial data address in the CCW 
is invalid, no data is transferred 
during the operation, and the device is 
signaled to conclude the operation in 
response to the first service request. 
On writing, devices such as magnetic- 
tape units request the first byte of 
data before any mechanical motion is 
started and, if the initial data address 
is invalid, the operation is terminated 
by the channel subsystem before the 
recording medium has been advanced. 
However, since the operation has been 
initiated at the device, the device 
presents channel-end status, causing the 
channel subsystem to recognize a primary 
interruption condition. Subsequently, 
the device also presents device-end 
status, causing the channel subsystem to 
recognize a secondary interruption 
condition. Whether a block at the 
device is advanced when no data is 
transferred depends on the type of 
devi ce. 



The storage areas designated for 
the operation are exhausted or 
filled. 



A program-check condition 
ted. 



i s detec- 



• A protection-check condition is de- 
tected. 

• A chaining-check condition is de- 
tected. 

• A channel-control-check condition 
is detected that does not affect 
the control of the I/O operation. 

The first of these conditions occurs 
when the channel subsystem has decre- 
mented the count to zero in the last CCW 
associated with the operation. A count 
of zero indicates that the channel 
subsystem has transferred all informa- 
tion specified by the I/O operation. The 
other four conditions are due to errors 
and cause premature conclusion of data 
transfer. In either case, the conclu- 
sion is signaled in response to a 
service request from the device and 
causes data transfer to cease. If the 
device has no blocks defined for the 
operation (such as writing on magnetic 
tape), it concludes the operation and 
presents channel-end status. 

The device can control the duration of 
an operation and the timing of channel 



When command chaining takes place, the 
subchannel is in the subchannel-and- 
devi ce-acti ve state from the time the 
first I/O operation is initiated at the 
device until the device presents 
channel-end status for the last I/O 
operation of the chain. The subchannel 
remains in the device-active state until 
the device presents the device-end 
status for the last I/O operation of the 
chai n. 

Any unusual conditions cause command 
chaining to be suppressed and a primary 
interruption condition to be generated. 
The unusual conditions can be detected 
by either the channel subsystem or the 
device, and the device can provide the 
indications with channel end, control- 
unit end, or device end. When the 
channel subsystem is aware of the unusu- 
al condition by the time the channel-end 
status for the operation is accepted, 
the chain is ended as if the operation 
during which the condition occurred were 
the last operation of the chain. The 
device-end status is recognized as a 
secondary interruption condition whether 
presented together with the channel-end 
status or separately. If the device 
presents unit check or unit exception 
together with either control-unit end or 
device end as status which causes the 
channel subsystem to recognize the 
primary interruption condition, then the 
subchannel-and-devi ce-acti ve state of 
the subchannel is terminated, and the 
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CHANNEL-PATH-RESET FUNCTION 



Subsequent to the execution of RESET 
CHANNEL PATH, the channel-path-reset 
function is performed. Performance of 
the function consists in: (1) issuing 
the reset signal on the designated chan- 
nel path and (2) causing a channel 
report to be made pending, indicating 
completion of the channel-path-reset 
functi on. 



CHANNEL-PATH-RESET-FUNCTION SIGNALING 



The channel subsystem issues the reset 
signal on the designated channel path. 
As part of this operation, the following 
actions are taken: 

1. All internal indications associated 
with control-unit busy, device 
busy, and allegiance conditions for 
the designated channel path are 
reset. These indications are reset 
at all subchannels that have access 
to the designated channel path. 
The reset function has no other 
effect on subchannels, including 
those having I/O operations in 
progress. 

2. If the channel path fails to 
respond properly to the reset 
signal (see the discussion of the 
reset signal in the section "1/0- 
System Reset" in Chapter 17, "I/O 
Support Functions," for a detailed 
description) or, because of a 
malfunction, the reset signal could 
not be i ssued, the channel path i s 
made physically available at each 
applicable subchannel. 

3. If an I/O operation is in progress 
at the device and the device is 
actively communicating on the chan- 
nel path in the execution of that 
I/O operation when the reset signal 
is received on that channel path, 
the I/O operation is reset, and the 
control unit and device immediately 
terminate current communication 
with the channel subsystem. (To 
avoid possible misinterpretation of 



unsolicited device-end status, 
programming measures can be taken 
as described in programming note 2 
below. ) 

If an I/O operation is in progress 
in multipath mode at the device and 
the device is not currently commu- 
nicating over the channel path in 
execution of that I/O operation 
when the reset signal is received, 
then the I/O operation may or may 
not be reset depending on whether 
another channel path is available 
for selection in the same multipath 
group for the device. If there is 
at least one other channel path in 
the multipath group for the device 
that is available for selection, 
the I/O operation is not reset. 
However, the channel path on which 
the system reset is received is 
removed from the current set of 
channel paths that form the multi- 
path group. If the channel path on 
which the reset signal is received 
is either the only channel path of 
a multipath group or the device is 
operating in single-path mode, the 
I/O operation is reset. 

The channel-path-reset function 
causes I/O operations to be termi- 
nated at the device as described 
above; however, I/O operations are 
never terminated at the subchannel 
by the channel-path-reset function. 

If an I/O operation is in progress 
at the subchannel and the channel 
path designated for the performance 
of the channel-path-reset function 
is being used for that I/O opera- 
tion, the subchannel may or may not 
accurately reflect the progress of 
the I/O operation up to that 
instant. The subchannel remains in 
the state that exists at the time 
the channel-path-reset 
performed until the 
changed because of 
taken by the program 
devi ce. 



function is 

state i s 

some action 

or by the 



CHANNEL-PATH-RESET FUNCTION-COMPLETION 
SIGNALING 



After the reset signal has been issued 
and an attempt has been made to issue 
the reset signal, or after it has been 
determined that the reset signal cannot 
be issued, the channel-path-reset func- 
tion is completed. (See the section 
"Reset Signal" in Chapter 17, "I/O 
Support Functions.") 

As a result of the channel-path-reset 
function being performed, a channel 
report is made pending (see the section 
"Channel-Subsystem Recovery" in Chapter 
17, "I/O Support Functions") to report 
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the results. If the channel path 
responds properly to the system-reset 
signal* the channel report indicates 
that the channel path has been initial- 
ized and is physically available for 
use. If the reset signal Mas issued but 
either the channel path failed to 
respond properly or the channel path Mas 
already not physically available at each 
subchannel having access to the channel 
path, the channel report indicates that 
the channel path has been initialized 
but is not physically available for use. 
If, because of a malfunction or because 
the designated channel path is not in 
the configuration, the reset signal 
could not be issued, the channel report 
indicates that the channel path has not 
been initialized and is not physically 
available for use. 



Programmi ng Notes 



If an I/O operation is in progress 
in multipath mode when the 
channel-path-reset function is 
performed on a channel path of the 
multipath group, it is 
the I/O operation to 
on a remaining channel 
group. 



possible for 

be continued 

path of the 



When the performance of the 
channel-path-reset function causes 



the I/O operation at the device to 
be reset, unsolicited device-end 
status presented by the device, if 
any, may be erroneously interpreted 
by the channel subsystem to be 
chaining status and thus cause the 
channel subsystem to continue the 
chain of commands. If this situ- 
ation occurs, the device-end status 
is not made available to the 
program and the device is selected 
again by the channel subsystem; 
however, the device may interpret 
the initiation sequence as the 
beginning of a neu channel program 
instead of command chaining. This 
possibility can be avoided by 
executing CLEAR SUBCHANNEL or HALT 
SUBCHANNEL, designating the 
affected subchannels, prior to 
executing RESET CHANNEL PATH. 

Execution of the channel-path-reset 
function may, on some models, cause 
overruns to occur on other channel 
paths. 

Even though reset is signaled on 
the designated channel path, alle- 
giances to that channel path by one 
or more devices may not have been 
reset because of a malfunction at a 
control unit or a malfunction at 
the physical channel path to the 
control unit. 



15-46 370-XA Principles of Operation 



CHAPTER 16. I/O INTERRUPTIONS 



Interruption Conditions 16-2 

Intermediate Interruption Condition 16-4 

Primary Interruption Condition 16-4 

Secondary Interruption Condition , 16-4 

Alert Interruption Condition 16-4 

Priority of Interruptions 16-4 

Interruption Action 16-5 

Interruption-Response Block (IRB) 16-6 

Subchannel-Status Word 16-6 

Subchannel Key 16-7 

Suspend Control (S) 16-8 

Extended-Status-Word Format (L) 16-8 

Deferred Condition Code (CO 16-8 

Format (F) 16-10 

Prefetch (P) 16-10 

Ini tial-Status-Interrupti on Control (I) 16-1 

Address-Limit-Checking Control (A) 16-1 

Suppress-Suspended Interruption (U) 16-1 

Subchannel-Control Field 16-1 

Zero Condition Code (Z) 16-1 

Extended Control (E) 16-1 

Path Not Operational (N) 16-12 

Function Control (FC) 16-12 

Activity Control (AC) 16-13 

Status Control (SO 16-16 

CCW-Address Field 16-18 

Device-Status Field 16-23 

Attent i on 16-23 

Status Modifier 16-23 

Control-Unit End 16-24 

Busy 16-25 

Channel End 16-25 

Device End 16-26 

Unit Check 16-26 

Unit Exception 16-27 

Subchannel-Status Field 16-28 

Program-Controlled Interruption 16-28 

Incorrect Length 16-28 

Program Check 16-28 

Protection Check 16-30 

Channel-Data Check 16-30 

Channel-Control Check 16-31 

Interface-Control Check 16-32 

Chaining Check 16-32 

Count Field 16-33 

Extended-Status Word 16-36 

Extended-Status Format 16-36 

Subchannel Logout 16-36 

Extended-Report Word 16-41 

Failing-Storage Address 16-41 

Extended-Status Format 1 16-41 

Extended-Status Format 2 16-41 

Extended-Status Format 3 16-42 

Extended-Control Word 16-44 



When an I/O operation o 
operations initiated by 
is ended, the channel 
device generate status 
generation of these c 
brought to the attentio 
by means of an I/O in 
TEST PENDING INTERRUPTI 
tain abnormal situatio 



r sequence of I/O 
START SUBCHANNEL 
subsystem and the 
conditions. The 
onditions can be 
n of the program 
terruption or by 
ON. (During cei — 
ns, these condi- 



tions can be brought to th 
the program by means of a 
interruption. See the s 
nel-Subsystem Recovery" i 
"I/O Support Functions," 
The status conditions, a 
address and a count i 
extent of the operation 
presented to the program 



e attention of 
machine-check 
ection "Chan- 
n Chapter 17, 
for details.) 
s well as an 
ndi eating the 
sequence, are 
in the form of 



Chapter 16. I/O Interruptions 16-1 



a subchannel-status word (SCSW). The 
SCSW is stored in an interruption- 
response block (IRB) during the 
execution of TEST SUBCHANNEL. 



interruption request and the inter- 
ruption condition can also be cleared by 
CLEAR SUBCHANNEL. 
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Normally an I/O operation 
execution until the device 
primary interruption status, 
interruption status 
during initiation of 
or later. An I/O 
terminated by the 
performing a clear or 
it detects an equipment malfunction* a 
program check* a chaining check* a 
protection check* or an incorrect-length 
condition* or by performing a clear, 
halt, or channel-path-reset function as 
a result of the program executing CLEAR 
SUBCHANNEL, HALT SUBCHANNEL, or RESET 
CHANNEL PATH, respectively. 

I/O interruptions provide a means for 
the CPU to change its state in response 
to conditions that occur at I/O devices 
or subchannels. These conditions can be 
caused by the program, by the channel 
subsystem, or by an external event at 
the device. 
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An I/O-interrupti on request remains 
pending until it is accepted by a CPU in 
the configuration, is withdrawn by the 
channel subsystem, or is cleared by TEST 
PENDING INTERRUPTION, TEST SUBCHANNEL, 
CLEAR SUBCHANNEL* or subsystem reset. 
When a CPU accepts an interruption 
request and stores the associated inter- 
ruption code, the interruption request 
is cleared. Alternatively* an 1/0- 
interruption request can be cleared by 
TEST PENDING INTERRUPTION. In either 
case, the subchannel remains status- 
pending until the associated 
interruption condition is cleared when 
TEST SUBCHANNEL is executed or the 
subchannel is reset. 

An I/O-i nterrupti on condition is normal- 
ly cleared by TEST SUBCHANNEL. If TEST 
SUBCHANNEL is executed, designating a 
subchannel that has an I/O-i nterrupti on 
request pending* both the interruption 
request and the interruption condition 
at the subchannel are cleared. The 
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When an I/O operation is terminated 
because of an unusual condition detected 
by the channel subsystem during the 
command initiation sequence* status 
describing the interruption condition is 
placed at the subchannel, causing it to 
become status-pending. If the unusual 
condition is detected by the device* the 
device-status field of the associated 
SCSW identifies the condition. 

When command chaining takes place* the 
generation of status by the device does 
not cause an interruption* and the 
status is not made available to the 
program. 

When the channel subsystem detects any 
of the following interruption condi- 
tions, it initiates a request for an I/O 
interruption without necessarily commu- 
nicating with, or having received the 
status byte from* the device: 

• A programming error associated with 
the contents of the ORB passed to 
the subchannel by the previous 
execution of START SUBCHANNEL 

• A valid suspend flag in the first 
CCW fetched that initiates 
channel-program execution for 
either START SUBCHANNEL or RESUME 
SUBCHANNEL, and suppress suspended 
interruption not specified in the 
ORB 

• A programming error associated with 
the first CCW or first IDAW 

These interruption conditions from the 
subchannel* except for the suspended 
condition, can be accompanied by other 
subchannel-status indications, but the 
device-status indications are all stored 
as zeros. 

The channel subsystem issues the clear 
signal to the device when status 
containing unit check is presented to a 
subchannel that is disabled or when the 
device is not associated with any 
subchannel. However, if the presented 
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status does not contain unit check, the 
status is accepted by the channel 
subsystem and discarded without causing 
the subchannel to become status-pending. 

An interruption condition caused by the 
device may be accompanied by multiple 
device-status conditions. Further, more 
than one interruption condition associ- 
ated with the same device can be 
accepted by the channel subsystem with- 
out an intervening I/O interruption. As 
an example, when the channel-end condi- 
tion is not cleared at the device by the 
time device end is generated, both 
conditions may be cleared at the device 
concurrently and indicated in the SCSW 
together. Alternatively, channel-end 
status may have been previously accepted 
at the subchannel, and an I/O intei — 
ruption may have occurred; however, the 
associated status-pending condition may 
not have been cleared by TEST SUBCHANNEL 
by the time device-end status was 
accepted at the subchannel. In this 
situation, the device-end status may be 
merged with the channel-end status with- 
out causing an additional I/O 
interruption. Whether an interruption 
condition may be merged at the subchan- 
nel with other existing interruption 
conditions depends upon whether the 
interruption condition is unsolicited or 
solicited. 

Unsolici ted Interrupti on Condi ti on : An 
unsolicited interruption condition is 
any interruption condition which is 
unrelated to the performance of a clear, 
halt, resume, or start function. An 



unsolicited interruption condition is 
identified at the subchannel as alert 
status. An unsolicited interruption 
condition can be generated only when the 
subchannel is not device-active. 
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Solici ted Interrupt! on Condi ti on : A 
solicited interruption condition is any 
interruption condition generated as a 
direct consequence of performing or 
attempting to perform a clear, halt, 
resume, or start function. Solicited 
interruption conditions include any 
interruption condition generated while 
the subchannel is either subchannel- 
and-devi ce-acti ve or device-active. The 
subchannel and device status associated 
with a solicited interruption condition 
may be merged at the subchannel with 
that of another currently existing 
solicited interruption condition. The 
figure "Interruption Condition for 
Status-Control-Bi t Combinations" 

describes the interruption condition 
that results from any combination of 
bits in the status-control field of the 
SCSW. 
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INTERMEDIATE INTERRUPTION CONDITION 



SECONDARY INTERRUPTION CONDITION 



An intermediate interruption condition 
is a solicited interruption condition 
that indicates the occurrence of an 
event for which the program previously 
requested notification. An intermediate 
interruption condition is described by 
solicited subchannel status, the Z bit, 
the subchannel-suspended condition, or 
any combination of the three. An intei — 
mediate interruption condition can occur 
only after it has been requested by the 
program through the use of flags in the 
ORB or a CCW. Depending on the state of 
the subchannel, execution or suspension 
of the I/O operation continues, unaf- 
fected by the setting of the 
intermediate-status bit. 

An intermediate interruption condition 
can be indicated only together with one 
of the following indications: 



A secondary interruption condition is a 
solicited interruption condition that 
normally indicates the completion of an 
I/O operation at the device. A second- 
ary interruption condition is also 
generated by the channel subsystem if 
the start function is terminated because 
a solicited alert interruption condition 
is recognized prior to initiating the 
first I/O operation at the device. A 
secondary interruption condition is 
described by the SCSW stored as a result 
of executing TEST SUBCHANNEL while the 
subchannel is status-pending with 
secondary status. Once the ^channel 
subsystem has accepted status from the 
device that causes a secondary intei — 
ruption condition to be recognized, the 
start function is completed at the 
devi ce. 



1. Subchannel-active 

2. Status-pending with 
alone 



primary status 



3. Status-pending with primary status 
together with alert status or 
secondary status or both 

4. Suspended 

If only the intermediate-status bit and 
the status-pending bit of the status- 
control field are ones during the 
execution of TEST SUBCHANNEL, the 
device-status field is zero. 



PRIMARY INTERRUPTION CONDITION 



A primary interruption condition is a 
solicited interruption condition that 
indicates the performance of the start 
function is completed at the subchannel. 
A primary interruption condition is 
described by the SCSW stored as a result 
of executing TEST SUBCHANNEL while the 
subchannel is status-pending with prima- 
ry status. Once the primary interrup- 
tion condition is indicated at the 
subchannel, the channel subsystem is no 
longer actively participating in the I/O 
operation by transferring commands or 
data. When a subchannel is status- 
pending with a primary interruption 
condition, execution of any of the 
following instructions results in the 
setting of a nonzero condition code: 
HALT SUBCHANNEL, MODIFY SUBCHANNEL, 
RESUME SUBCHANNEL, and START SUBCHANNEL. 
Once the primary interruption condition 
is cleared by executing TEST SUBCHANNEL, 
the subchannel accepts 
SUBCHANNEL instruction, 
section "START SUBCHANNEL" 
14, "I/O Instructions.") 



the START 

(See the 

in Chapter 



ALERT INTERRUPTION CONDITION 



An alert interruption condition is 
either a solicited interruption condi- 
tion that indicates the occurrence of an 
unusual condition in a halt, resume, or 
start function or an unsolicited inter- 
ruption condition that describes a 
condition unrelated to the performance 
of a halt, resume, or start function. 
An alert interruption condition is 
described by the SCSW stored as a result 
of executing TEST SUBCHANNEL while the 
subchannel is status-pending with alert 
status. An alert interruption condition 
may be generated by either the channel 
subsystem or the device. Nonzero alert 
status is always brought to the atten- 
tion of the program. Whenever the 
subchannel is idle and zero status is 
presented by the device, the status is 
di scarded. 



PRIORITY OF INTERRUPTIONS 



All requests for an 
asynchronous to any 
and interruption 
with more than one 
at the same time 



I/O interruption are 
activity in any CPU, 
requests associated 
subchannel can exist 
The priority of 
interruptions is controlled by two types 
of mechanisms — one establishes within 
the channel subsystem the priority among 
interruption requests from subchannels 
associated with the same 1/0- 
interruption subclass, and another 
establishes within a given CPU the 
priority among requests from subchannels 
of different I/O-interrupti on sub- 
classes. The channel subsystem requests 
an I/O interruption only after it has 
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established priority among requests from 
its subchannels. The conditions respon- 
sible for the requests are preserved at 
the subchannels until cleared by a CPU 
executing TEST SUBCHANNEL or CLEAR 
SUBCHANNEL or until I/0-system reset is 
performed. 

The assignment of priority among 
requests for interruption from subchan- 
nels of the same I/O-i nterrupti on 
subclass is in the order that the need 
for interruption is recognized by the 
channel subsystem. The order of recog- 
nition by the channel 
function of the type 
condition and the type 
For the type of channel 
channel subsystem, the 
the electrical position 
the channel path to 
attached. A device's 



tion on the I/O interface 
to its device address. 



subsystem 1 s a 
of interruption 
of channel path, 
path used by the 
order depends on 
of the device on 
which it is 
electrical posi- 



is not related 



The assignment of priority among 
requests for interruption from subchan- 
nels of different I/O-i nterrupti on 
subclasses is made by the CPU according 
to the numerical value of the 1/0- 
interruption subclass codes (with zero 
having highest priority), in conjunction 
with the I/O-i nterrupti on subclass mask 
in control register 6. The numerical 
value of the I/O-i nterrupti on subclass 
code is directly related to the bit 
position in the I/O-i nterrupti on 
subclass mask in control register 6 of a 
CPU. If in any CPU an I/O-i nterrupti on 
subclass-mask bit is zero, then all 
subchannels having an I/O-interrupt i on 
subclass code numerically equal to the 
associated position in the mask register 
are said to be masked off in the respec- 
tive CPU. Therefore, a CPU accepts the 
highest-priority I/O-i nterrupti on re- 
quest from a subchannel which has the 
lowest-numbered I/O-i nterrupti on sub- 
class code that is not masked off by a 
corresponding bit in control register 6 
of that CPU. When the highest-priority 
interruption request is accepted by a 
CPU, it is cleared so that the inter- 
ruption request is not accepted by any 
other CPU in the configuration. 



The priority of 
can be modified 
TEST SUBCHANNEL 
When either of 
executed and th 
has an interru 
that i nterrupti 
without regard 
lished priority, 
of the remainin 
is unchanged. 



interruption handling 
by execution of either 

or CLEAR SUBCHANNEL, 
these instructions is 
e designated subchannel 
ption request pending, 
on request is cleared, 
to any previous estab- 

The relative priority 
g interruption requests 



Proqrammi ng Notes 



The I/O-interruption subclass mask 
is in control register 6, which has 
the following formats 



ISC Mask 



Reserved 



2. 
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Control register 6 is set to all 
zeros during initial CPU reset. 



INTERRUPTION ACTION 



An I/O interruption can occur only when 
the I/O-interruption subclass-mask bit 
associated with the subchannel is one 
and the CPU is enabled for I/O intei — 
ruptions. The interruption occurs at 
the completion of a unit of operation 
(see the section "Point of Interruption" 
in Chapter 5, "Program Execution"). If 
the channel subsystem established the 
priority among requests for interruption 
from subchannels while the CPU was disa- 
bled for I/O interruptions, the 
interruption occurs immediately after 
completion of the instruction enabling 
the CPU and before the next instruction 
is executed, provided that the I/O- 
interruption subclass-mask bit 
associated with the subchannel is one. 
Alternatively, if the channel subsystem 
has established the priority among 
requests for interruption from subchan- 
nels while the I/O-interruption 
subclass-mask bit is zero for each 
subchannel which is status-pending, the 
interruption occurs immediately after 
completion of the instruction which sets 
at least one of the I/O-interruption 
subclass-mask bits to one, provided that 
the CPU is also enabled for I/O intei — 
ruptions. This interruption is 
associated with the highest-priority 
I/O-interruption request, as established 
by the CPU. 
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The interruption causes the current PSW 
to be stored as the old PSW at real 
location 56 and causes the I/O- 
interruption code associated with the 
interruption to be stored at real 
locations 184-191 of the CPU allowing 
the interruption. Subsequently, a new 
PSW is loaded from real location 120, 
and processing resumes in the CPU state 
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indicated by that PSW. The subchannel 

causing the interruption is identified 

by the interruption code. The 1/0- 

interruption code has the following 
format when it is stored: 

Hex. Dec. 



B8 184 
BC 188 



Subsystem-Identification Word 



Interruption Parameter 
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While a CPU is accepting an interruption 
request, no other CPU can accept an 
interruption request from a subchannel 
of the same I/O-i nterruption subclass. 
However, other CPUs may accept a pending 
interruption request from a subchannel 
of a different I/O-interrupti on 
subclass. After the interruption has 
occurred, other CPUs can accept a pend- 
ing interruption request from a 
subchannel of the same I/O-i nterrupti on 
subclass, if any remain. 



Word 
1 
2 

3 
4 
5 
6 
7 



15 



Subchannel-Status Word 



Extended-Status Word 



Extended-Control Word / 



The length of the subchannel-status and 
extended-status words is 12 bytes and 20 
bytes, respectively. The length of the 
extended-control word is 32 bytes. When 
the extended-control bit (bit 14, word 
0) of the SCSW is zero, words 8-15 of 
the interruption-response block may or 
may not be stored. 



Programming Note 



SUBCHANNEL-STATUS WORD 



The I/O-interrupti on subclass code for 
all subchannels is set to zero by 1/0- 
system reset. It may be set to any of 
the values 0-7 by executing MODIFY 
SUBCHANNEL. (The operation of the 
instruction is described in the section 
"MODIFY SUBCHANNEL" in Chapter 14, "I/O 
Instructi ons.") 



The subchannel-status word (SCSW) 
provides to the program indications 
describing the status of a subchannel 
and its associated device. If perform- 
ance of a halt, resume, or start func- 
tion has occurred, the SCSW may describe 
the conditions under which the operation 
was concluded. 



INTERRUPTION-RESPONSE BLOCK (IRB) 



The interruption-response block (IRB) is 
the operand of TEST SUBCHANNEL. The two 
rightmost bits of the IRB address are 
zeros, designating the IRB on a word 
boundary. The IRB contains three major 
fields: the subchannel-status word, the 
extended-status word, and the extended- 
control word. The format of the IRB is 
as follows: 



The SCSW is stored when TEST SUBCHANNEL 
is executed and the designated subchan- 
nel is operational. The SCSW is placed 
in words 0-2 of the IRB that is desig- 
nated as the TEST SUBCHANNEL operand. 
When STORE SUBCHANNEL is executed, the 
SCSW is stored in words 7-9 of the 
subchannel-information block (described 
in the section "Subchannel-Information 
Block" in Chapter 15, "Basic I/O Func- 
tions"). The format of the SCSW is as 
follows: 
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Word 






Key 


S 


L 


CC 


F 


P 


I 


A 


U 


Z 


E 


N 





FC 


AC 


SC 


1 


CCW Address 


2 


Device Status 


Sch Status 


Count 



Bits 

Word Q 

0-3 

5 

6-7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17-19 

20-26 



27-31 



4 
Name 



16 



20 



27 



31 



(S) 



CI) 



Subchannel key 

Suspend control 

ESW format (L) 

Deferred condition code (CC) 

Format (F) 

Prefetch (P) 

Initial-status interruption control 

Address-limit-checking control (A) 

Suppress-suspended interruption (U) 

Zero condition code (Z) 

Extended control (E) 

Path not operational (N) 

Reserved (0) 

Function control (FC) 

(bit 17, start function; bit 18, halt function; 

bit 19, clear function) 
Activity control (AC) 

(bit 20, resume-pending; bit 21, start-pending; 

bit 22, halt-pending; bit 23, clear-pending; 

bit 24, subchannel-active; bit 25, device-active; 

bit 26, suspended) 
Status control (SC) 

(bit 27, alert status; bit 28, intermediate status; 

bit 29, primary status; bit 30, secondary status; 

bit 31, status-pending) 



Word 1 




0-31 


CCW add 


Word 2 




0-7 


Device 




(bit 




bit 2 




bit 4 




bit 6 


8-15 


Subchan 




(bit 




bit 1 




bit 1 




bit 1 


16-31 


Count 



status 

0, attention; bit 1, status modifier; 

, control-unit end; bit 3, busy; 

, channel end; bit 5, device end; 

, unit check; bit 7, unit exception) 

nel status (Sch Status) 

8, program-controlled interruption; bit 9, incorrect length; 

0, program check; bit 11, protection check; 

2, channel-data check; bit 13, channel-control check; 

4, interface-control check; bit 15, chaining check) 



SCSW Format 



The contents of the subchannel-status 
word (SCSW) depend on the state of the 
subchannel when the SCSW is stored. 
Depending on the state of the subchannel 
and the device, the specific fields of 
the SCSW may contain (1) information 
pertaining to the last operation, 
(2) information unrelated to the 
execution of an operation, (3) zeros, or 
(4) a value of no meaning. The follow- 
ing descriptions indicate when an SCSW 
field contains meaningful information. 



Subchannel Key 



When the start-function bit (bit 17 of 
word 0) is one, bits 0-3 of word 
contain the access key used during 
performance of the associated start 
function. These bits are identical with 
the key specified in the ORB (bits 0-3 
of word 1). The subchannel key is mean- 
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ingful only when the start-fur?cti on bit 
(bit 17 of word 0) is one. 



Suspend Control (S) 



When the start-function bit (bit 17 of 
word 0) is one, bit 4 of word 0, when 
one, indicates that the suspend function 
can be initiated at the subchannel. Bit 
4 is meaningful only when bit 17 is one. 
If bit 17 is one and bit 4 is one, 
channel-program execution can be 
suspended if the channel subsystem 
recognizes a valid S flag which is set 
to one in a CCW. If bit 4 is zero, 
channel-program execution cannot be 
suspended, and if an S flag set to one 
in a CCW is recognized, a program-check 
condition is recognized. 



Extended-Status-Word Format (L) 



When the status-pending bit (bit 31 of 
word 0) is one, bit 5 of word 0, when 
one, indicates that a format-0 ESW has 
been stored. A format-0 ESW is stored 
when an interruption condition contain- 
ing one of the following indications is 
cleared by TEST SUBCHANNEL: 

Channel-data check 
Channel-control check 
Interface-control check 
Measurement-block-program check 
Measurement-block-data check 
Measurement-block-protect i on check 

The extended-status-word-format bit is 
meaningful whenever the subchannel is 
status-pending. The extended-status 
information that is used to form a 
format-0 ESW is cleared at the subchan- 
nel by TEST SUBCHANNEL or CLEAR 
SUBCHANNEL. 



Deferred Condition Code (CO 



When the start-function bit (bit 17 of 
word 0) is one and the status-pending 
bit (bit 31 of word 0) is also one, bits 
6-7 of word indicate the general 
reason that the subchannel was status- 
pending when TEST SUBCHANNEL or STORE 
SUBCHANNEL was executed. The deferred 
condition code is meaningful when the 
subchannel is status-pending with any 
combination of status and only when the 
start-function bit of the function- 
control field in the SCSW is one. The 
meaning of the deferred condition code 
for each value when the subchannel i s 
status-pending is given in the figure 
"Deferred-Condition-Code Meaning for 
Status-Pending Subchannel." 



The deferred condition code, if not 
zero, is used to indicate whether condi- 
tions have been encountered that 
preclude the subchannel becoming 
subchannel-and-devi ce-acti ve while the 
subchannel is either start-pending or 
suspended. 

Deferred Condi ti on Code J): A normal I/O 
interruption has taken place. 

Deferred Condi ti on Code JL.: Status is 
present in the SCSW that was presented 
by the associated device or generated by 
the channel subsystem subsequent to the 
setting of condition code for START 
SUBCHANNEL or RESUME SUBCHANNEL. If 
only the alert-status bit and the 
status-pending bit of the status-control 
field of the SCSW are ones, the status 
present is not related to the execution 
of a channel program. If the 
intermediate-status bit, the primary- 
status bit, or both are ones, then the 
status is related to the execution of 
the channel program specified by the 
most recently executed START SUBCHANNEL 
instruction or implied by the most 
recently executed RESUME SUBCHANNEL 
instruction. (See the section "Immedi- 
ate Conclusion of I/O Operations" in 
Chapter 15, "Basic I/O Functions.") If 
the secondary-status bit is one and the 
primary-status bit is zero, the status 
present is related to the channel 
program specified by the START SUBCHAN- 
NEL instruction or implied by the RESUME 
SUBCHANNEL instruction that preceded the 
most recently executed START SUBCHANNEL 
i nstructi on. 

Deferred Condi ti on Code 2: This code 
does not occur and is reserved for 
future use. 

Deferred Condi ti on C ode 3: An attempted 
device selection has occurred, and the 
device appeared not operational on all 
of the channel paths that were available 
for selection of the device. 

A device appears not operational when it 
does not respond to a selection attempt 
by the channel subsystem. This occurs 
when the control unit is not provided in 
the system, when power is off in the 
control unit, or when the control unit 
has been logically switched off the 
channel path. The not-operational state 
is also indicated when the control unit 
is provided and is capable 
the device, but the device 
installed and the control 
designed to recognize the 
selected as one of its attached devices. 
(Sea also the section "I/O Addressing" 
in Chapter 13, "I/O Overview.") 



of attaching 
has not been 
unit is not 
device being 



A deferred condition code 3 also can be 
set by the channel subsystem if no chan- 
nel paths to the device are available 
for selection. (See the figure 
"Deferred-Condition-Code Meaning for 
Status-Pending Subchannel.") 
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Programming Notes 



1. If, during performance of a start 
function, the I/O device being 
selected is not installed or has 
been logically removed from the 
control unit, but the associated 
control unit is operational and the 
control unit recognizes the I/O 
device being selected as one of its 
I/O devices (for example, access 
mechanism 7 on the IBM 3830 Storage 
Control that has only access mech- 
anisms 0-3 installed), the control 
unit, depending upon the model, 
either fails to recognize the 
address of the I/O device or 
considers the I/O device to be not 
ready. In the former case, a 
path-not-operational condition is 
recognized, subject to the setting 
of the path-operational mask. (See 
the discussion of path-operational 
mask in the section "Subchannel- 
Information Block" in Chapter 15, 
"Basic I/O Functions.") In the 
latter case, the not-ready condi- 
tion is indicated when the control 
unit responds to the selection and 



indicates unit check whenever the 
not-ready state precludes success- 
ful initiation of the operation at 
the I/O device. In this case, 
unit-check status is indicated in 
the SCSW, the subchannel becomes 
status-pending with primary, 
secondary, and alert status, and 
with deferred condition code 1 
indicated. (See the section "Unit 
Check" in this chapter.) Refer to 
the System Library publication for 
the control unit to determine how 
the condition is indicated. 

2. The deferred condition code is 1 
and the status-control field 
contains the status-pending and 
intermediate-status bits or the 
status-pending, intermediate- 
status, and alert-status bits as 
ones when HALT SUBCHANNEL has been 
executed and the designated 
subchannel is suspended and 
status-pending with intermediate 
status. If the alert-status bit is 
one, then subchannel-logout infor- 
mation was generated as a result of 
attempting to issue the halt signal 
to the device. 
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Status 




Bit 6 


Bit 7 


Control 1 


Meaning 








A I P S X 
A I P - X 
A - P S X 
A - P - X 

- I P S X 

- I P - X 

- - P S X 

- - P - X 


Normal I/O interruption 





1 


A I P S X 


Either an immediate operation, with 






A I P - X 


chaining not specified* has ended not — 






A I - - X 2 


mally, or the setting of some status 






A - P S X 


condition precluded the initiation or 






A - P - X 


resumption of a requested I/O opera- 






A S X 


tion at the device. 






A X 








- I P S X 








- I P - X 








- I - - X 2 








- - P S X 








P - X 








S X 3 








X 2 3 

/ 




1 





Reserved 


Reserved 


1 


1 


- - P S X 


The device is not operational on any 






- I P S X 


available path or, if a dedicated- 
allegiance condition exists, the 
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The condition is encountered after the execution of HALT 




SUBCHANNEL when the 


subchannel is currently suspended. 
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The condition is encountered after the execution of HALT 




SUBCHANNEL when the 


subchannel is currently start-pending. 
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Alert status. 
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Intermediate status 
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Primary status. 
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Secondary status. 




X 


Status-pendi ng. 





Deferred-Condition-Code Meaning for Status-Pending Subchannel 



Format (F) 



Prefetch (P) 



When the start-function bit (bit 17 of 
word 0) is one, bit 8 of word indi- 
cates the format of the CCWs associated 
with an I/O operation. The format bit 
is meaningful only when bit 17 is one. 
If bit 8 of word is zero, format-0 
CCWs are indicated. If it is one, 
format-1 CCWs are indicated. (See the 
section "Channel-Command Word" in Chap- 
ter 15, "Basic I/O Functions" for the 
description of the two CCW formats.) 



When the start- 
word 0) is one, 
cates whether or 
ing of CCWs is 
bit is meani ngf 
one. If bit 9 
one CCW descri 
allowed during 
operations and i 
other operation 
unlimited pref 
allowed. 



function bit (bit 17 of 
bit 9 of word indi- 
not unlimited prefetch- 
allowed. The prefetch 
ul only when bit 17 is 
is zero, prefetching of 
bing a data area is 
output-data-chai ni ng 
s not allowed during any 
s. If bit 9 is one, 
etching of CCWs is 
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Ini tial -Stat us- Interrupti on Control (I) 



When the sta 
word 0) is o 
one, indicate 
tern is to 
i nterruption 
becomes sub 
description o 
section "Ope 
Chapter 15, " 
10 of word 0, 
the subchan 
active is no 
interrupti on 



rt-function bit (bit 17 of 
ne, bit 10 of word 0, when 
s that the channel subsys- 
generate an intermediate 
condition if the subchannel 
channel-active (see the 
f bit 10, word 1, in the 
ration-Request Block" in 
Basic I/O Functions"). Bit 
when zero, indicates that 
nel becoming subchannel- 
t to cause an intermediate 
condition to be generated. 



The program requests the intermediate 
interruption condition by means of the 
ORB. An I/O interruption that results 
from that request may be due to the 
channel subsystem performing either a 
start function or a resume function. 
(See the description of bit 13, word 
later in this section for details of the 
indication given by the channel subsys- 
tem when the intermediate interruption 
condition is cleared by TEST 
SUBCHANNEL). 



Address-Li mi t-Checki ng Control (A) 



When the start-function bit (bit 17 of 
word 0) is one, bit 11 of word 0, when 
one, indicates that the channel subsys- 
tem has been requested by the program to 
perform address-limit checking, subject 
to the setting of the limit mode at the 
subchannel (see the description of bit 
11, word 1, in the section "Operation- 
Request Block" in Chapter 15, "Basic I/O 
Functions"). The address-limit- 
checking-control bit is meaningful only 
when bit 17 is one. 



SUBCHANNEL-CONTROL FIELD 



The following subchannel-control-infor- 
mation descriptions apply to the 
subchannel-control field (bits 13-31 of 
word 0) of the SCSW. 



Zero Condi tion Code (Z) 



Bit 13 of word 0, when one, indicates 
that the subchannel has become 
subchannel-active and the channel 
subsystem has recognized an initial- 
status-interruption condition at the 
subchannel. The Z bit is meaningful 
only when the intermediate-status bit 
(bit 28 of word 0) and the start- 
function bit (bit 17 of word 0) are both 
ones. 

If the initial-status-interruption- 
control bit (bit 10, word 1 of the ORB) 
is one when START SUBCHANNEL is 
executed, then the subchannel becoming 
subchannel-active causes the subchannel 
to be made status-pending with interme- 
diate status indicating the initial- 
status-interruption condition. The 
initial-status-i nterrupti on condition 
remains at the subchannel until the 
intermediate interruption condition is 
cleared by the execution of TEST 
SUBCHANNEL or CLEAR SUBCHANNEL. If the 
i ni tial- status- i nterruption-control bit 
of the ORB is zero when START SUBCHANNEL 
is executed, then the subchannel becom- 
ing subchannel-active does not cause an 
intermediate interruption condition to 
be generated, and the initial-status- 
interruption condition is not 
recognized. 



Extended Control (E) 



Suppr ess-Suspended Interrupti on (U) 



When the start-function bit (bit 17 of 
word 0) is one, bit 12 of word 0, when 
one, indicates that the channel subsys- 
tem has been requested by the program to 
suppress the generation of an intermedi- 
ate interruption condition due to 
suspension when the subchannel becomes 
suspended (see the description of bit 
12, word 1, in the section "Operation- 
Request Block" in Chapter 15, "Basic I/O 
Functions"). When bit 12 is zero, the 
channel subsystem generates an interme- 
diate interruption condition whenever 
the subchannel is suspended during 
execution of the associated channel 
program. The suppress-suspended- 
interruption bit is meaningful only when 
bit 17 is one. 



Bit 14 of word 
that model-depe 
stored in the 
(ECW). When b 
contents of word 
stored, are unpre 
meaningful whene 
status-pending wi 
alone or togethe 
secondary status, 



Programming Note 



0, when one, indicates 
ndent information is 

extended-control word 
it 14 is zero, the 
s 0-7 of the ECW, if 
dictable. The E bit is 
ver the subchannel i s 
th alert status either 
r with primary status, 

or both. 



During execution of TEST SUBCHANNEL, the 
storing of words 0-7 of the ECW is a 
model-dependent function subject to the 
setting of bit 14 as described above. 
Therefore, the program should always 
provide sufficient storage to accommo- 
date the storing of a 64-byte IRB. 
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Path Not Operational (N) 



Bit 15 of word 0, when one, indicates 
that the N condition has been recognized 
by the channel subsystem. The N condi- 
tion, in turn, indicates that one or 
more path-not-operational conditions 
have been recognized. The channel 
subsystem recognizes a path-not- 
operational condition when, during an 
attempted device selection in order to 
perform a clear, halt, resume, or start 
function, the device associated with the 
subchannel appears not operational on a 
channel path that is operational for the 
subchannel. A channel path is opera- 
tional for the subchannel if the 
associated device appeared operational 
on that channel path the last time the 
channel subsystem attempted device 
selection in order to perform a clear, 
halt, resume, or start function. A 
channel path is not operational for the 
subchannel if the associated device 
appeared not operational on that channel 
path the last time the channel subsystem 
attempted device selection in order to 
perform a clear, halt, resume, or start 
function. A device appears to be opera- 
tional on a channel path when the device 
responds to an attempted device 
selecti on. 

The N bit is meaningful whenever the 
status-control field contains one of the 
indications listed below, and at least 
one basic I/O function is also indicated 
at the subchannel: 

• Status-pending with any combination 
of primary, secondary, or alert 
status 

• Status-pending alone 

• Status-pending with intermediate 
status when the subchannel is also 
suspended 

The N condition is reset whenever the 
execution of TEST SUBCHANNEL results in 
the setting of condition code and the 
N bit is meaningful as described above. 



Notes 



A path-not-operational condition 
does not imply a malfunctioning 
channel path. A malfunctioning 
channel path causes the generation 
of an error indication, such as 
interface-control check. 

When a path-not-operational condi- 
tion has been recognized and the 
subchannel subsequently becomes 
status-pending with only intermedi- 
ate status, the path-not- 
operational condition continues to 
be recognized until the subchannel 



becomes status-pending with primary 
status or becomes suspended and is 
indicated by storing the path-not- 
operational bit as a one during the 
execution of TEST SUBCHANNEL. When 
a path-not-operational condition 
has been recognized and the 
channel-program execution subse- 
quently becomes suspended, the 
path-not-operational condition does 
not remain pending if channel- 
program execution is subsequently 
resumed. Instead, the old indi- 
cation is lost, and the path-not- 
operational indication, if any, 
pertains to the attempt by the 
channel subsystem to resume 
channel-program execution. 



Function Control (FC) 



The function-control field indicates the 
basic I/O functions that are indicated 
at the subchannel. This field may indi- 
cate the acceptance of as many as two 
functions. The function-control field 
is contained in bit positions 17-19 of 
the first word of the SCSW. The 
function-control field is meaningful at 
an installed subchannel whenever the 
subchannel is valid (see the discussion 
of the device-number-valid bit in the 
section "Subchannel-Information Block" 
in Chapter 15, "Basic I/O Functions"). 
The function-control field contains all 
zeros whenever both the activity- and 
status-control fields contain all zeros. 
The meaning of the individual bits is as 
follows: 

Start Function ( Bi t 17) : When one, bit 

17 indicates that a start function has 
been requested and is either pending or 
in progress at the subchannel. A start 
function is requested by executing START 
SUBCHANNEL. A start function is indi- 
cated at the subchannel when condition 
code is set during the execution of 
START SUBCHANNEL. The start-function 
indication is cleared at the subchannel 
when TEST SUBCHANNEL is executed and the 
subchannel is either status-pending 
alone, or status-pending with any combi- 
nation of alert, primary, or secondary 
status. The start-function indication 
is also cleared at the subchannel during 
the execution of CLEAR SUBCHANNEL. 

Halt Function ( Bit 18): When one, bit 

18 indicates that a halt function has 
been requested and is either pending or 
in progress at the subchannel. A halt 
function is requested by executing HALT 
SUBCHANNEL. A halt function is indi- 
cated at the subchannel when condition 
code is set for HALT SUBCHANNEL. The 
halt-function indication is cleared at 
the subchannel when the next status- 
pending condition which occurs is 
cleared by execution of TEST SUBCHANNEL. 
The next status-pending condition 
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depends on the state of the subchannel 
when HALT SUBCHANNEL is executed. If 
the subchannel is subchannel-active when 
HALT SUBCHANNEL is executed, then the 
next status-pending condition is 
status-pending with at least primary 
status indicated. If the subchannel is 
device-active when HALT SUBCHANNEL is 
executed, then the next status-pending 
condition is status-pending with at 
least secondary status indicated. If 
the subchannel is suspended and status- 
pending with intermediate status when 
HALT SUBCHANNEL is executed, then the 
next status-pending condition is 
status-pending with intermediate status. 
If the subchannel is idle when HALT 
SUBCHANNEL is executed, then the next 
status-pending condition is status- 
pending alone. The halt-function 
indication is also cleared at the 
subchannel during the execution of CLEAR 
SUBCHANNEL. In normal operations, this 
function is indicated together with bit 
17; that is, there is a start function 
either pending or in progress which is 
to be halted. 

Clear Functi on ( Bi t 19) : When one, bit 
19 indicates that a clear function has 
been requested and is either pending or 
in progress at the subchannel. A clear 
function is requested by executing CLEAR 
SUBCHANNEL. A clear function is indi- 
cated at the subchannel when condition 
code is set for CLEAR SUBCHANNEL (see 
the section "CLEAR SUBCHANNEL" in Chap- 
ter 14, "I/O Instructions"). The clear 
function indication is cleared at the 
subchannel when the resulting status- 
pending condition is cleared by TEST 
SUBCHANNEL. 



Activity Control (AC) 



The activity-control field is contained 
in bit positions 20-26 of the first word 
of the SCSW. This field indicates the 
current progress of a basic I/O function 
previously accepted at the subchannel. 
By using the contents of this field, the 
program can determine the degree of 
completion of the basic I/O function. 
The activity-control field is meaningful 
at an installed subchannel whenever the 
subchannel is valid (see the discussion 
of the device-number-valid bit in the 
section "Subchannel-Information Block" 
in Chapter 15, "Basic I/O Functions"). 
However, if an IFCC or CCC condition is 
detected during the performance of a 
basic I/O function and that function is 
indicated as pending, I/O operations may 
or may not have been executed at the 
device. The activity-control bits are 
defined as follows: 



Bi t Designation 

20 Resume-pending 

21 Start-pending 

22 Halt-pending 

23 Cleai — pending 

24 Subchannel-active 

25 Device-active 

26 Suspended 

When an SCSW is stored that has the 
status-pending bit of the status-control 
field zero and all zeros in the 
activity-control field, the subchannel 
is said to be idle or in the idle state. 

Note : All conditions that are repres- 
ented by the bits in the function- 
control field and by the resume-pending, 
start-pending, halt-pending, cleai — 
pending, subchannel-active, and 
suspended bits in the activity-control 
field are reset at the subchannel when 
TEST SUBCHANNEL is executed and the 
subchannel (1) is status-pending alone, 
(2) is status-pending with primary 
status, (3) is status-pending with alert 
status, or (4) is status-pending with 
intermediate status and is also 
suspended. 

Resume-Pending ( Bi t 20) : When one, bit 
20 indicates that the subchannel is 
resume-pending. The channel subsystem 
may or may not be in the process of 
performing the start function. The 
subchannel becomes resume-pending when 
condition code is set for RESUME 
SUBCHANNEL. The point at which the 
subchannel is no longer resume-pending 
is a function of the subchannel state 
existing when the resume-pending condi- 
tion is recognized and the state of the 
device if channel-program execution is 
resumed. 

If the subchannel is in the suspended 
state when the resume-pending condition 
is recognized, the CCW that caused the 
suspension is ref etched, the setting of 
the suspend flag is examined, and one of 
the following actions is taken by the 
channel subsystem: 

1. If the CCW suspend flag is one, the 
device is not selected, the 
subchannel is no longer resume- 
pending, and channel-program 
execution remains suspended. 

2. If the CCW suspend flag is zero, 
the channel subsystem attempts to 
resume channel-program execution by 
performing a modified start func- 
tion. The resumption of channel- 
program execution appears to the 
device as the initiation of a new 
channel-program execution. The 
resume function causes the channel 
subsystem to execute the path- 
management operation as if a new 
start function were being 
initiated, using the ORB parameters 
previously passed to the subchannel 
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by START SUBCHANNEL with the excep- 
tion that the channel-program 
address i s the address of the CCW 
that previously caused suspension 
of channel-program execution. 

The subchannel remains resume- 
pending when* during the perform- 
ance of the start function* the 
channel subsystem (1) determines 
that it is not possible to attempt 
to initiate the I/O operation for 
the. first command, (2) determines 
that an attempt to initiate the I/O 
operation for the first command 
does not result in the command 
being accepted* or (3) detects an 
IFCC or CCC condition and is unable 
to determine whether the first 
command has been accepted. (See 
the section "Start Function and 
Resume Function" in Chapter 15* 
"Basic I/O Functions.") 

The subchannel is no longer 
resume-pending when any of the 
following events occurs: 

a. While performing the start 
function* the subchannel 
becomes subchannel-and-devi ce- 
active or device-active only* 
or the first command is 
accepted with channel-end and 
device-end initial status and 
the CCW does not specify 
command chaining. 

b. CLEAR SUBCHANNEL is executed. 

c. TEST SUBCHANNEL clears any 
combination of primary* second- 
ary* and alert status or clears 
the status-pending condition 
alone. 

d. TEST SUBCHANNEL clears interme- 
diate status while the subchan- 
nel is suspended. 

If the subchannel is not in the 
suspended state when the resume-pending 
condition is recognized* the CCW suspend 
flag of the most recently fetched CCW* 
if any* is examined and one of the 
following actions is taken by the chan- 
nel subsystem: 

1. If a CCW has not been fetched or 
the suspend flag of the most 
recently fetched CCW is zero* the 
subchannel is no longer resume- 
pending* and the resume function is 
not performed. 



2. If the suspend flag 
recently fetched CCW 
subchannel is no lo 
pending* and the CCW 
The subchannel pr 
channel-program execu 
suspend flag of the 
is zero. The subchan 
channel-program execu 



of the most 
is one* the 
nger resume- 
is ref etched, 
oceeds with 
tion if the 
refetched CCW 
nel suspends 
tion if the 



suspend flag of the refetched CCW 
is one. 

Some models recognize a resume-pending 
condition only after a CCW having a 
valid S flag set to one is fetched. 
Therefore* if a subchannel is resume- 
pending and* during execution of the 
channel program* no CCW is fetched that 
has a valid S flag set to one* the 
subchannel remains resume-pending until 
the primary interruption condition is 
cleared by TEST SUBCHANNEL. 

Start-Pendi ng ( Bit 21 ) : When one* bit 
21 indicates that the subchannel is 
start-pending. The channel subsystem 
may or may not be in the process of 
performing the start function. The 
subchannel becomes start-pending when 
condition code is set for START 
SUBCHANNEL. The subchannel remains 
start-pending when* during the perform- 
ance of the start function* the channel 
subsystem (1) determines that it is not 
possible to attempt to initiate the I/O 
operation for the first command* 
(2) determines that an attempt to initi- 
ate the I/O operation for the first 
command does not result in the command 
being accepted* or (3) detects an IFCC 
or CCC condition and is unable to detei — 
mine whether the first command has been 
accepted. (See the section "Start Func- 
tion and Resume Function" in Chapter 15* 
"Basic I/O Functions.") 

The subchannel becomes no longer start- 
pending when any of the following 
occurs: 

1. While performing the start func- 
tion* the subchannel becomes 
subchannel-and-devi ce-acti ve or 
device-active only* or the first 
command is accepted with channel- 
end and device-end initial status 
and the CCW does not specify 
command chaining. 

2. The subchannel becomes suspended 
because of a valid suspend flag in 
the first CCW. 

3. CLEAR SUBCHANNEL is executed. 

4. TEST SUBCHANNEL clears any combina- 
tion of primary* secondary* and 
alert status or clears the status- 
pending condition alone. 



Halt-Pending ( Bit 22): When 
indicates that the subchann 
pending. The channel subsy 
may not be in the process o 
the halt function. The 
becomes halt-pending when co 
is set for HALT SUBCH 
subchannel remains halt-pe 
during the performance of th 
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attempt to issue the halt signal to the 
device is not successful, or (3) detects 
an IFCC or CCC condition and is unable 
to determine whether the halt signal is 
issued to the device. (See the section 
"Halt Function" in Chapter 15, "Basic 
I/O Functions.") 

The subchannel is no longer halt-pending 
when any of the following occurs: 

1. While performing the halt function, 
the channel subsystem determines 
that the halt signal has been 
issued to the device. 

2. CLEAR SUBCHANNEL is executed. 

3. TEST SUBCHANNEL clears any combina- 
tion of primary, secondary, and 
alert status or clears the status- 
pending condition alone. 

4. TEST SUBCHANNEL clears intermediate 
status while the subchannel is 
suspended. 

Clear-Pending ( Bit 23): When one, bit 
23 indicates that the subchannel is 
cleai — pending. The channel subsystem 
may or may not be in the process of 
performing the clear function. The 
subchannel becomes cleai — pending when 
condition code is set for CLEAR 
SUBCHANNEL. The subchannel remains 
clear-pending when, during performance 
of the clear function, the channel 
subsystem (1) determines that it is not 
possible to attempt to issue the clear 
signal to the device, (2) determines 
that the attempt to issue the clear 
signal to the device is not successful, 
or (3) detects an IFCC or CCC condition 
and is unable to determine whether the 
clear signal is issued to the device. 
(See the section "Clear Function" in 
Chapter 15, "Basic I/O Functions.") 

The subchannel is no longer clear- 
pending when either of the following 
occurs: 

1. While performing the clear 
function, the channel subsystem 
determines that the clear signal 
has been issued to the device. 

2. TEST SUBCHANNEL clears the status- 
pending condition alone. 

Subchannel-Acti ve ( Bi t 24) : When one, 
bit 24 indicates that the subchannel is 
subchannel-active. A subchannel is said 
to be subchannel-active when an I/O 
operation is currently in execution at 
the subchannel . The subchannel becomes 
subchannel-active when the first command 
is accepted for any of the following 
initial-status combinations and the 
start function or resume function is not 
immediately concluded at the subchannel. 
(See the section "Immediate Conclusion 
of I/O Operations" in Chapter 15, "Basic 
I/O Functions.") 



1. All zeros 

2. Unit check, status modifier, and 
channel end when used to indicate 
command retry (delayed). (See the 
section "Command Retry in Chapter 
15, "Basic I/O Functions.") 

3. Unit check, status modifier, chan- 
nel end, and device end when used 
to indicate command retry (immedi- 
ate). (See the section "Command 
Retry" in Chapter 15, "Basic I/O 
Functions.") 

4. Channel end when the chain-command 
flag is one in the CCW 

5. Channel end and device end when the 
chain-command flag is one in the 
CCW 

6. Channel end, device end, and status 
modifier when the chain-command 
flag is one in the CCW 

The subchannel is no longer subchannel- 
active when any of the following occurs: 

1. The subchannel becomes suspended. 

2. The subchannel becomes status- 
pending with primary status. 

3. CLEAR SUBCHANNEL is executed. 

4. The device appears not operational 
during performance of a halt func- 
ti on. 

The subchannel does not become 
subchannel-active during performance of 
the function specified by either a HALT 
SUBCHANNEL or a CLEAR SUBCHANNEL 
instructi on. 

Devi ce-Acti ve ( Bi t 25): When one, bit 
25 indicates that the subchannel is 
device-active. A subchannel is said to 
be device-active when an I/O operation 
is currently in progress at the associ- 
ated device. The subchannel becomes 
device-active when the first command is 
accepted for: 

1. One of the combinations of initial 
status listed above in the section 
"Subchannel-Active" 

2. Initial status of channel end with 
neither busy nor device end, and 
command chaining is not specified 
in the CCW. (See the section 
"Immediate Conclusion of I/O Oper- 
ations" in Chapter 15, "Basic I/O 
Functions.") 

The subchannel is no longer device- 
active when any of the following occurs: 

1. The subchannel becomes suspended. 
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2. The subchannel becomes status- 
pending with secondary status. 

3. CLEAR SUBCHANNEL is executed. 

4. The device appears not operational 
during performance of a halt func- 
ti on. 

If the subchannel is not start-pending 
or if the status accepted from the 
device also describes an alert 
condition, the subchannel becomes 
status-pending with secondary status. 
After the status has been accepted from 
the device, the device is capable of 
accepting a command for executing a new 
I/O operation. If the subchannel is 
start-pending and the status is device 
end or device end with control-unit end, 
then the channel subsystem discards the 
status and performs the start function 
for the new channel program. (See the 
section "Start Function and Resume Func- 
tion" in Chapter 15, "Basic I/O 
Functions.") In this situation, the 
subchannel does not become status- 
pending with the secondary interruption 
condition, and the status is not made 
available to the program. 

The subchannel does not become device- 
active during performance of the func- 
tions specified by either a HALT 
SUBCHANNEL or a CLEAR SUBCHANNEL 
i nstructi on. 



Suspended ( Bit 26) - When 
indicates that the s 
suspended. A subchannel 
suspended when channel-pro 
is currently suspended, 
becomes suspended as part 
function. (See the secti 
of Channel-Program Executi 
15, "Basic I/O Functions." 



one, bit 26 
ubchannel is 
is said to be 
gram execution 
The subchannel 
of the suspend 
on "Suspension 
on" in Chapter 
) 



The subchannel is no longer suspended 
when any of the following occurs: 

1. As part of the resume function 
following the execution of RESUME 
SUBCHANNEL when the subchannel be- 
comes subchannel-and-devi ce-acti ve 
or device-active only, or the first 
command is accepted for channel-end 
and device-end initial status, with 
or without status modifier, and the 
CCU does not specify command chain- 
i ng. 

2. CLEAR SUBCHANNEL is executed. 

3. TEST SUBCHANNEL clears any combina- 
tion of primary, secondary, and 
alert status or clears the status- 
pending condition alone. 

4. TEST SUBCHANNEL clears intermediate 
status while the halt function is 
specif i ed. 



does not mean that 

stopped for the 

cannot determine 

has stopped until 



Programming Note 



When an SCSW is stored by STORE SUBCHAN- 
NEL or TEST SUBCHANNEL following CLEAR 
SUBCHANNEL but prior to the subchannel 
becoming status-pending, and the 
subchannel-active bit (bit 24 of word 0) 
is stored as 0, this 
data transfer has 
device. The program 
whether data transfer 
the subchannel becomes status-pending as 
a result of performing the clear func- 
ti on. 



Status Control (SO 



The status-control field is contained in 
bit positions 27-31 of the first word of 
the SCSW. This field provides the 
program with a summary-level indication 
of the interruption condition described 
by either subchannel or device status, 
the Z bit, or, in the case of the 
subchannel-suspended interruption, the 
suspended bit (bit 26). More than one 
summary indication may be signaled as a 
result of existing conditions at the 
subchannel. Whenever the subchannel is 
enabled (see the description of bit 8, 
word 1, in the section "Subchannel- 
Information Block" in Chapter 15, "Basic 
I/O Functions") and at least bit 31 is 
one, the subchannel is said to be 
status-pending. Whenever the subchannel 
is disabled, the subchannel is not made 
status-pending. Bit 31 of SCSW word 
is meaningful at an installed subchannel 
whenever the subchannel is valid (see 
the discussion of the device-number- 
valid bit in the section "Subchannel- 
Information Block" in Chapter 15, "Basic 
I/O Functions"); bits 27-30 are meaning- 
ful when bit 31 is one. The status- 
control bits are defined as follows: 
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subchannel status or 
Alert status is sta 
either the channel 
device under any of th 
ti ons: 



: When one (and 
i ng bit is also 
s an alert intei — 
ists. In such a 
is said to be 
lert status. An 
ndition is recog- 
us is present at 
rt status may be 
device status, 
tus generated by 
subsystem or the 
e following condi- 



The subchannel is idle (activity- 
control bits 20-26 and status- 
control bit 31 sre zeros). 

The subchannel is start-pending, 
and the status condition precludes 
initiation of the I/O operation. 
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• The subchannel is subchannel-and- 
devi ce-acti ve, and the status 
condition has suppressed command 
chaining or would have suppressed 
command chaining if chaining had 
been specified (see the section 
"Channel-Command Word" in Chapter 
15, "Basic I/O Functions"). 

• The subchannel i s subchannel-and- 
devi ce-acti ve, command chaining is 
not specified, execution of the 
channel program has just been 
concluded, and the status presented 
by the device is attempting to 
alter the sequential execution of 
commands (see the section "Status 
Modifier" later in this chapter). 

• The subchannel is device-active 
only, and the status presented by 
the device is other than device 
end, control-unit end, or device 
end and control-unit end. 

• The subchannel is suspended (bit 26 
i s one) . 

If the subchannel is start-pending when 
an alert interruption condition is 
recognized, the subchannel becomes 
status-pending with alert status, 
deferred condition code 1 is set, the 
start-pending bit remains one, and 
execution of the pending I/O operation 
i s not i ni tiated. 

When TEST SUBCHANNEL is executed and 
stores an SCSW with the alert-status bit 
and the status-pending bit as ones in 
the IRB, the alert interruption condi- 
tion is cleared at the subchannel. The 
alert interruption condition is also 
cleared during execution of CLEAR 
SUBCHANNEL. 

Whenever alert status i s present at the 
subchannel, it is brought to the atten- 
tion of the program. Examples of alert 
status include attention, device end 
(which signals a transition from the 
not-ready to the ready state), incorrect 
length, program check, and unit check. 

Intermediate Status ( Bit 28 ) : When one 
(and when the status-pending bit is also 
one), bit 28 indicates an intermediate 
interruption condition exists. In such 
a case, the subchannel is said to be 
status-pending with intermediate status. 
Intermediate status can be indicated 
when the Z bit (of the subchannel-con- 
trol field), the suspended bit (of the 
activity-control field), or the PCI bit 
(of the subchannel-status field) is one. 

When the initial-status-interruption- 
control bit is one in the ORB, the 
subchannel becomes status-pending with 
intermediate status (the Z bit 
indicated) only after initial status is 
received for the first CCW of the chan- 
nel program and the subchannel i s 
subchannel-active. If the subchannel 



does not become subchannel-active, 
condition is not generated. 



the Z 



When suspend control is specified and 
the generation of an intermediate intei — 
ruption condition due to suspension is 
not suppressed in the ORB, then the 
subchannel can become status-pending 
with intermediate status due to suspen- 
sion if a CCW becomes current that con- 
tains the suspend flag set to one. When 
the suspend flag is specified in the 
first CCW of a channel program, 
channel-program execution is suspended 
and the subchannel becomes status- 
pending with intermediate status (the 
suspended bit indicated) before the 
command in the first CCW is transferred 
to the device. When the suspend flag is 
specified in a CCW fetched during 
command chaining, channel-program 
execution is suspended and the subchan- 
nel becomes status-pending with 
intermediate status (the suspended bit 
indicated) only after execution of the 
preceding CCW is complete. 

When the PCI flag is specified in a CCW, 
the generation of an intermediate inter- 
ruption condition due to PCI depends on 
whether the CCW is the first CCW of the 
channel program. When the PCI flag is 
specified in the first CCW of a channel 
program, the subchannel becomes status- 
pending with intermediate status (the 
PCI bit indicated) only after initial 
status is received for the first CCW of 
the channel program indicating the 
command has been accepted. When the PCI 
flag is specified in a CCW fetched while 
chaining, the subchannel becomes 
status-pending with intermediate status 
(the PCI bit indicated) only after 
execution of the preceding CCW is 
complete. If chaining occurs before an 
interruption condition containing PCI is 
cleared by TEST SUBCHANNEL, the condi- 
tion is carried over to the next CCW. 
This carryover occurs during both data 
and command chaining, and, in either 
case, the condition is propagated 
through the transfei — in-channel command. 

If the subchannel is status-pending with 
intermediate status when HALT SUBCHANNEL 
is executed, the intermediate intei — 
ruption condition remains at the sub- 
channel, but the interruption request, 
if any, is withdrawn, and the subchannel 
becomes no longer status-pending. The 
subchannel remains no longer status- 
pending until performance of the halt 
function has ended. The subchannel then 
becomes status-pending with intermediate 
status indicated (possibly together with 
any combination of primary, secondary, 
and alert status). 

When TEST SUBCHANNEL is executed and 
stores an SCSW with the intermediate- 
status bit and the status-pending bit as 
ones in the IRB, the intermediate intei — 
ruption condition is cleared at the 
subchannel. The intermediate intei — 



Chapter 16. I/O Interruptions 16-17 



ruption condition is also cleared at the 
subchannel during the execution of CLEAR 
SUBCHANNEL. 

Primary Status ( Bit 29) : When one (and 
when the status-pending bit is also 
one), bit 29 indicates a primary i ntei — 
ruption condition exists. In such a 
case, the subchannel is said to be 
status-pending with primary status. A 
primary interruption condition is a 
solicited interruption condition that 
indicates the completion of the start 
function at the subchannel. The primary 
interruption condition is described by 
the SCSW stored. When an I/O operation 
is terminated by HALT SUBCHANNEL but the 
halt signal is not issued to the device 
because the device appeared not opera- 
tional, the subchannel is made status- 
pending with primary status (and 
secondary status) with both the 
subchannel-status field and the device- 
status field set to zero. 

When TEST SUBCHANNEL is executed and 
stores an SCSW with the primary-status 
bit and the status-pending bit as ones 
in the IRB, the primary interruption 
condition is cleared at the subchannel. 
The primary interruption condition is 
also cleared at the subchannel during 
the execution of CLEAR SUBCHANNEL. 

Secondary Status ( Bi t 30 ) : When one 
(and when the status-pending bit is also 
one), bit 30 indicates a secondary 
interruption condition exists. In such 
a case, the subchannel is said to be 
status-pending with secondary status. A 
secondary interruption condition is a 
solicited interruption condition that 
normally indicates the completion of the 
I/O operation at the device. The 
secondary interruption condition is 
described by the SCSW stored. 

When an I/O operation is terminated by 
HALT SUBCHANNEL but the halt signal is 
not issued to the device because the 
device appeared not operational, the 
subchannel is made status-pending with 
secondary status (and primary status if 
the subchannel is also subchannel- 
active) with zeros for subchannel and 
device status. 



HALT SUBCHANNEL is executed, designating 
a subchannel that is idle, the subchan- 
nel becomes status-pending subsequent to 
performance of the halt function to 
notify the program that the halt func- 
tion has been completed. When TEST 
SUBCHANNEL is executed, thus storing an 
SCSW with the status-pending bit as one 
in the IRB, the status-pending condition 
is cleared at the subchannel. The 
status-pending condition is also cleared 
at the subchannel during the execution 
of CLEAR SUBCHANNEL. When CLEAR SUB- 
CHANNEL is executed, and the designated 
subchannel is operational, the subchan- 
nel becomes status-pending subsequent to 
performance of the clear function to 
notify the program that the clear func- 
tion has been completed. 

Note : The status-pending bit, in 
conjunction with the remaining bits of 
the status-control field, indicates the 
type of status condition. For example, 
if bits 29 and 31 are ones, the subchan- 
nel is status-pending with primary sta- 
tus. Alternatively, if only bit 31 is 
one, then the subchannel is said to be 
status-pending or status-pending alone. 
If only bit 31 is one in the status- 
control field, the settings of all bits 
in the subchannel- and device-status 
fields are unpredictable. If bit 31 is 
not one, then the remaining bits of the 
status-control field are not meaningful. 



CCW-ADDRESS FIELD 



Bits 1-31 of word 1 form an absolute 
address. The address indicated is a 
function of the subchannel state when 
the SCSW is stored, as indicated in the 
figure "CCW Address as 
channel State." When 
status field indicates 
check, channel-data 
interface-control check, 
field is usable for recovery purposes if 
the CCW-address field-validity flag in 
the ESW is one. 



Function of Sub- 
the subchannel- 
channel -control 
check, or 
the CCW-address 



Programming Note 



When TEST SUBCHANNEL is executed and 
stores an SCSW with the secondary-status 
bit as one in the IRB, the secondary 
interruption condition is cleared at the 
subchannel. The secondary interruption 
condition is also cleared at the 
subchannel during execution of CLEAR 
SUBCHANNEL. 

Status-Pending ( Bit 31) : When one, bit 
31 indicates that the subchannel is 
status-pending and that information 
describing the cause of the interruption 
condition is available to the program. 
The subchannel becomes status-pending 
whenever intermediate, primary, second- 
ary, or alert status is generated. When 



When a CCW address, either detected in 
the channel-program address (see the 
section "Operation-Request Block" in 
Chapter 15, "Basic I/O Functions") or 
generated during chaining, would cause 
the channel subsystem to fetch a CCW 
from a location greater than 16,777,215 
while format-0 CCWs are specified for 
the operation, the invalid address is 
stored in the CCW-address field of the 
SCSW without truncation. If the invalid 
address causes the channel subsystem, 
while chaining, to fetch a CCW from a 
location greater than 2,147,483,647 
while in the 31-bit addressing mode, the 
rightmost 31 bits of the invalid address 
are stored in the CCW-address field. 



16-18 370-XA Principles of Operation 



Subchannel State 1 



Start-pending (UUUUO/AIPSX) 3 

Start-pending and device-active 
(UUUUO/AIPSX) 3 

Subchannel-and-devi ce-acti ve 
(UUUUO/AIPSX) 3 

Device-active only (UUUUO/AIPSX) 

Suspended (YYYYY/AIPSX) 3 

Status-pending (10001/AIPSX) 
because of unsolicited alert 
status from the device while the 
subchannel was start-pending 3 

Status-pending (0Y111/AIPSX) 
because the device appeared 
not operational on all paths 3 

Status-pending (10011/AIPSX) 
because of solicited alert status 
from the device while the sub- 
channel was start-pending and 
devi ce-acti ve 3 

Status-pending ( 10111/AIPSX) 
because of solicited alert status 
generated by the channel subsys- 
tem while the subchannel was 
start-pending 3 or start-pending 
and device-active 3 

Status-pending (01001/AIPSX) 
for the program-controlled- 
interruption condition while the 
subchannel was subchannel-and- 
devi ce-acti ve 3 

Status-pending (01001/AIPSX) 
for the ini tial-status-i ntei — 
ruption condition while the 
subchannel was subchannel-and- 
devi ce-acti ve 3 

Status-pending ( 1Y1Y1/AIPSX) ; 
termination occurred because of 
program check caused by one of 
the following conditions: 3 

Bit 24, word 1 of ORB set to 
one; incorrect-length-indica- 
tion-suppression facility not 
installed 

Unused bits in ORB not set to 
zeros 

Invalid CCW-address specifica- 
tion in transfer in channel 
(TIC) 

Invalid CCW-address specifica- 
tion in the channel-program 
address in the ORB 



CCW Address 2 



Unpredi ctable 
Unpredictable 

Unpredi ctable 

Unpredictable 

See note 1 

Channel-program address + 8 

Channel-program address + 8 
Channel-program address + 8 

See note 2 



CCW + 8 of the CCW that con- 
tained the last recognized PCI, 
or 8 higher than a CCW which has 
subsequently become current 



CCW + 8 of the CCW causing the 
intermediate interruption 
condition, or 8 higher than a 
CCW which has subsequently 
become current 



Channel-program address + 8 



Channel-program address + 8 



Address of TIC + 8 



Channel-program address + 8* 



CCW Address as Function of Subchannel State (Part 1 of 4) 
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Subchannel State 1 



Invalid CCW address in TIC 

Invalid CCW address in the 
channel^program address in 
the ORB 

Invalid CCW address while 
chai ni ng 

Invalid command code 

Invalid count 

Invalid IDAW-address specifi- 
cati on 

Invalid IDAW address in a CCW 

Invalid IDAW address while 
sequentially fetching IDAWs 

Invalid data-address specifi- 
cation, format 1 

Invalid data address in a CCW 

Invalid data address while 
sequentially accessing storage 

Invalid data address in IDAW 

Invalid IDAW specification 

Invalid CCW, format or 1, 
for a CCW other than a TIC 

Invalid suspend flag — CCW 
fetched during data chaining 
has suspend flag set to one 

Invalid suspend flag — CCW 
has suspend flag set to one, 
but suspend control was not 
specified in the ORB 

Invalid CCW, format 1, for a 
TIC 

Invalid sequence — two TICs 

Invalid sequence — 256 or 
more CCWs without data trans- 
fer 

Status-pending (1Y1Y1/AIPSX) ; 
termination occurred because 
of protection check detected 
as follows: 3 

On a CCW access 



On data or an IDAW access 



CCW Address 2 



Address of TIC + 8 
Channel-program address + 8* 

Invalid CCW address + 8 

Address of invalid CCW + 8 5 

Address of invalid CCW + 8 5 

Address of invalid CCW + 8 5 

Address of invalid CCW + 8 5 

Address of current CCW + 8 

Address of invalid CCW + 8 s 

Address of invalid CCW + 8 5 

Address of current CCW + 8 

Address of current CCW + 8 

Address of current CCW + 8 

Address of invalid CCW + 8 5 

Address of invalid CCW + 8 

Address of invalid CCW + 8 

Address of TIC + 8 

Address of second TIC + 8 
Address of 256th CCW + 8 



Address of the protected CCW 
+ 8 s 

Address of current CCW + 8 



CCW Address as Function of Subchannel State (Part 2 of 4) 
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Subchannel State 1 



Status-pending (1Y1Y1/AIPSX) ; 
termination occurred because 
of chaining check 3 

Status-pending (YY1Y1/AIPSX) ; 
termination occurred under 
count control 3 

Status-pending ( 1Y1Y1/AIPSX) ; 
operation prematurely terminated 
by the device because of alert 
status 3 

Status-pending (YYYY1/AIPSX) 
after termination by HALT 
SUBCHANNEL and the activity- 
control-field bits indicated 
below set to ones: 

Status-pending alone 

Start-pending 3 

Device-active and 
start-pending 3 

Device-active 

Subchannel-active and 
devi ce-acti ve 3 

Suspended 

Suspended and resume-pending 

Status-pending (00001/AIPSX) 
after termination by CLEAR 
SUBCHANNEL 

Status-pending (YY1Y1/AIPSX); 
operation completed normally at 
the subchannel 3 



Status-pending 
Status-pending 
Status-pending 



(00011/AIPSX) 
(10001/AIPSX) 
(00001/AIPSX) 



Status-pending (1Y111/AIPSX) ; 
command chaining suppressed 
because of alert status other 
than channel-control check or 
interface-control check 3 

Status-pending ( 1YYY1/AIPSX) 
because of alert status for 
channel-control check or 
interface-control check 3 

Status-pending ( 1Y1Y1/AIPSX) 
because of channel-data check 3 



CCU Address 2 



Address of current CCW + 8 



Address of current CCW + 8* 



Address of current CCW + 8 6 



Unpredictable 
Unpredictable 
Unpredictable 

Unpredictable 

CCW + 8 of the last executed CCW 

CCW + 8 of CCW causing suspension 

Unpredictable 

Unpredictable 

CCW + 8 of the last executed CCW 6 

Unpredictable 
Unpredictable 
Unpredictable 
Address of current CCW + 8* 



See note 3 6 



Address of current CCW + 8* 



CCW Address as Function of Subchannel State (Part 3 of 4) 
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Explanati on: 



The meaning of the notation used in this column is as 
follows: 

A Alert status 

I Intermediate status 

P Primary status 

S Secondary status 

X Status-pending 
The possible combination of status-control-bit settings is 
shown to the left of the "/" symbol by the use of these 
symbols: 

Corresponding condition is not indicated. 

1 Corresponding condition is indicated. 

U Unpredictable. The corresponding condition is not 
meaningful when the subchannel is not status-pending. 

Y The corresponding condition is not significant and is 
indicated as a function of the subchannel state. 



2 A CCW becomes current when (1) it is the f 
nel program and has been fetched, (2) whil 
the previous CCW is no longer current and 
been fetched, or (3) in the case of data c 
CCW takes over control of the I/O operatio 
"Data Chaining" in Chapter 15, "Basic I/O 
chaining is not specified or is suppressed 
longer current and becomes the last-execut 
ary status has been accepted by the channe 
command chaining, a CCW is no longer curre 
status has been accepted or, in the case o 
when the last byte of data for that CCW ha 

3 The subchannel may also be resume-pending. 



i rst CCW of a chan- 
e command chaining, 
the new CCW has 
haining, the new 
n (see the section 
Functions"). If 

a CCW i s no 
ed CCW when second- 
1 subsystem. During 
nt when device-end 
f data chaining, 
s been accepted. 



4 The stored address is the channel-program address (in the 
ORB) + 8 even though it is either invalid or protected. 

5 The stored address is the address of the current CCW + 8 even 
though it is either invalid or protected. 

6 Incorrect length is indicated as a function of the setting of 
the suppress-length-indi oati on flag in the current CCW (see 
the section "Channel-Command Word" in Chapter 15, "Basic I/O 
Functions") . 



Notes: 



1. Unless the subchannel is also resume-pending, the address 
stored is the address of the CCW that caused suspension, 
plus 8. Otherwise, the address stored is unpredictable. 

2. The address of the CCW is given as a function of the alert 
status indicated. For example, if a program-check or pro- 
tection-check condition is recognized, the CCW address stored 
is the same as for the entry for program check or protection 
check, respectively, in this table. Alternatively, if alert 
status for interface-control check or channel-control check 
is indicated, the CCW address stored is either the channel- 
program address (in the ORB) + 8 or invalid as specified by 
the field-validity flags in the subchannel logout. 

3. Bit 21 of the subchannel-logout information, when stored 
as one, indicates that the address is CCW + 8 of the last- 
fetched CCW if the command for the CCW has not been accepted 
by the device. If the command has been accepted by the 
device at the time the error condition is recognized, then 
the address stored is the address of the CCW + 8 of the last 
executed CCW. 



CCW Address as Function of Subchannel State (Part 4 of 4) 
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DEVICE-STATUS FIELD 



Device-status conditions are generated 
by the I/O device and are presented to 
the channel subsystem over the channel 
path. The timing and causes of these 
conditions for each type of device are 
specified in the System Library publica- 
tion for the device. The device-status 
field is meaningful whenever the 
subchannel is status-pending with any 
combination of primary, secondary* 
intermediate, or alert status. Whenever 
the subchannel is status-pending with 
intermediate status alone, the device- 
status field is zero. When the 
subchannel-status field indicates 
channel-control check, channel-data 
check, or interface-control check, the 
device-status field is usable for recov- 
ery purposes if the device-status 
field-validity flag in the ESW is one. 
When the subchannel is status-pending 
with deferred-condition code 3 
indicated, the contents of the device- 
status field are not meaningful. 

If, within a system, the I/O device is 
accessible from more than one channel 
path, status related to channel- 
subsystem-initiated operations in 
single-path mode (solicited status) is 
signaled over the initiating channel 
path. Devices operating in multipath 
mode may signal solicited status over 
any channel path that belongs to the 
same path group as the initiating chan- 
nel path. The handling of conditions 
not associated with I/O operations 
(unsolicited alert status), such as 
attention, unit exception, and device 
end due to transition from the not-ready 
to the ready state, depends on the type 
of device and condition and is specified 
in the System Library publication for 
the device. 

The channel subsystem does not modify 
the status bits received from the I/O 
device. These bits appear in the SCSW 
as received over the channel path. 



Attenti on 



Attention is generated when the device 
detects an asynchronous condition that 
is significant to the program. The 
condition may also be described by other 
status indications that accompany atten- 
tion. Attention is interpreted by the 
program and is not associated with the 
initiation, execution, or conclusion of 
an I/O operation. 

The device can signal the attention 
condition to the channel subsystem when 
no operation is in progress at the I/O 
device. Attention can be indicated with 
device end upon completion of an opera- 
tion, and it can be presented to the 



channel subsystem during 
of a new I/O operation. 



the initiation 



When the device signals attention during 
the initiation of an operation, the 
operation is not initiated. Attention 
accompanying device end causes command 
chaining and command retry to be 
suppressed. 



attention 
and unit 



An I/O device may present 
accompanied by device end 
exception when a transition is made from 
the not-ready to the ready state (see 
the section "Device End" later in this 
chapter) . 



Status Modifier 



Status modifier is generated by the 
device when the device cannot provide 
its current status in response to intei — 
rogation by the channel subsystem, when 
the control unit is busy, when the 
normal sequence of commands has to be 
modified, or when command retry is to be 
ini tiated. 



When the device is i 
status-modifier cond 
the absence of any 
this indicates that 
provide its current 
ruption condition, wh 
at the device, is not 
Transmission Control 
type of device that 
current status as a 
subsystem interrogati 



nterrogated and the 
ition signaled, in 
other status bit, 
the device cannot 
status. The intei — 
i ch may be pending 
cleared. The 2702 
is an example of a 
cannot provide its 
result of channel- 
on. 



Presence of status modifier and device 
end means that the normal sequence of 
commands must be modified. The handling 
of this set of bits by the channel 
subsystem depends on the operation. If 
command chaining is specified in the 
current CCW and no unusual conditions 
have been detected, presence of status 
modifier and device end causes the chan- 
nel subsystem to fetch and chain to the 
CCW whose main-storage address is 16 
higher than that of the current CCW. If 
the I/O device signals the status- 
modifier condition at a time when no 
command chaining is specified, or when 
any unusual conditions have been 
detected, no action is taken by the 
channel subsystem, and the status- 
modifier bit is placed in the SCSW. 

Status modifier is presented in combina- 
tion with unit check and channel end to 
initiate the command-retry procedure. 

Control units that recognize special 
conditions which must be brought to the 
attention of the program present status 
modifier along with other status indi- 
cations in order to modify the meaning 
of the status. The status presented is 
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unrelated 
operati on. 



to the execution of an I/O 



When status modifier is generated 
together with the busy status bitt it 
indicates that the busy condition 
pertains to the control unit associated 
with the addressed I/O device. The 
control unit appears busy when it is 
executing a type of operation that 
precludes the acceptance and execution 
of any command and may appear busy when 
it contains status or sense information 
for a device other than the one 
addressed. The status may be control- 
unit end or channel end following the 
performance of the halt function. The 
busy state occurs for operations such as 
backspace tape file, in which case the 
control unit remains busy after provid- 
ing channel end for operations concluded 
by HALT SUBCHANNEL. The busy state 
temporarily occurs on the IBM 3705 
Communication Controller after initi- 
ation of an operation on a device 
accommodated by the control unit. A 
control unit accessible from two or more 
channel paths appears busy to the other 
channel paths when it is communicating 
with any of the channel paths. 



Control-Unit End 



Control-unit end indicates that 
control unit has become available 
use for another operation. 



the 
for 



The control-unit-end condition is 
provided only by control units shared by 
I/O devices or control units accessible 
by twp or more channel paths, and only 
when one or both of the following condi- 
tions have occurred: 

1. The channel subsystem had previous- 
ly caused the control unit to be 
interrogated while the control unit 
was busy. The control unit is 
considered to have been interro- 
gated in the busy state when a 
command has been transferred to a 
device on the control unit, and the 
control unit had responded with 
busy and status modifier in the 
device status byte. 



The control unit d 
al condition durin 
the operation afte 
been signaled t 
subsystem. The i 
unusual conditi 
control-unit end. 
signaling of cont 
device end does 
describe an unusua 



etected an unusu- 
g the portion of 
r channel end had 

the channel 
ndi cation of the 
on accompanies 

However, the 

rol-unit end and 

not necessarily 

1 condi : :i on. 



The two conditions described above are 
reset by the reset signal and the clear 
signal. Therefore, if one of these 
signals occurs before control-unit end 



is generated, no control-unit end is 
generated. If control-unit end has been 
generated but not presented to the chan- 
nel subsystem by the time one of the 
signals occurs, the pending control-unit 
end is reset. 

If the control unit remains busy with 
the execution of an operation after 
signaling channel end but has not 
detected any unusual conditions and has 
not been interrogated by the channel 
subsystem, control-unit end is not 
generated. Similarly, control-unit end 
is not provided when the control unit 
has been interrogated and could perform 
the indicated function. The latter case 
is indicated by the absence of busy and 
status modifier in the response to the 
interrogati on. 

When the busy condition of the control 
unit is temporary, control-unit end may 
be included with busy and status modifi- 
er in response to the interrogation even 
though the control unit has not yet been 
freed. The busy condition is considered 
to be temporary if its duration is 2 
milliseconds or less. If a temporary 
busy condition is indicated, the channel 
subsystem assumes the responsibility to 
periodically reinterrogate the control 
unit until it is no longer busy. The 
IBM 3705 Communications Controller is an 
example of a device in which the control 
unit may be busy temporarily and which 
includes control-unit end with busy and 
status modifier. 

The control-unit end condition can be 
signaled with channel end, with device 
end, or between the two. 

Control-unit end may be signaled at 
other times and may be accompanied by 
other status bits. When control-unit 
end is signaled in the absence of any 
other status, the status may be identi- 
fied with any device recognized by the 
control unit. For control units attach- 
ing more than a single I/O device, a 
pending control-unit end for one I/O 
device does not necessarily preclude 
initiation of new operations with other 
attached devices. Whether the control 
unit allows initiation of other opei — 
ations is at the option of the control 
uni t . 

When control-unit end is presented to 
the channel subsystem subsequent to the 
acceptance of channel end and is accom- 
panied by other status indications, 
command chaining is suppressed, if spec- 
ified, and an interruption condition may 
be generated indicating one or more of 
the following conditions: 

1. A secondary interruption condition, 
in the following cases: 

a. Control-unit end accompanied by 
device end and other status 
indications, or 
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b. Control-unit end accompanied by 

only device end while the 

subchannel is not start- 
pending. 

2. An alert interruption condition, in 
the following cases: 

a. Control-unit end accompanied by 
device end while the subchannel 
is subchannel-active, or 

b. Control-unit end accompanied by 
status other than device end. 

3. A primary interruption condition if 
the subchannel is subchannel- 
acti ve. 

When control-unit end alone is presented 
to the channel subsystem, the channel 
subsystem resets internal indications of 
control unit busy and discards the 
control-unit-end status without recog- 
nizing an interruption condition, unless 
all of the following conditions are met: 

1. Control-unit end is presented on 
the channel path with which the 
channel subsystem is maintaining a 
working allegiance for this 
subchannel . 

2. The device is not operating in 
multipath mode (see the discussion 
of multipath mode in the section 
"Path-Management-Control Word" in 
Chapter 15, "Basic I/O Functions"). 



The subchannel i s 
device-acti ve. 



subchannel -and- 



4. Channel-end status has been previ- 
ously presented, and command chain- 
ing is specified. 

If all of the above conditions are met, 
the channel subsystem suppresses command 
chaining and recognizes an interruption 
condition indicating primary, secondary, 
and alert status. In addition, when the 
status-verification facility is 
installed and active, the device- 
status-check bit is set to one. 

Control-unit end presented with channel 
end i s unusual status and causes the 
channel subsystem to suppress command 
chaining, if specified, and recognize an 
interruption condition for the subchan- 
nel with primary and alert status 
i ndicated. 



Busy 



Busy indicates that the device cannot 
execute the command because (1) it is 
executing a previously initiated opera- 
tion, (2) it has pending status which 
must be presented to the channel subsys- 
tem, (3) the device is currently inac- 
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Whenever the device indicates that a 
busy condition exists and it is unable 
to execute an operation, the device 
responds to the channel subsystem when 
it becomes no longer busy (see the 
section "Device End" later in this chap- 
ter). 



Channel End 



Channel end is caused by the completion 
of the portion of an I/O operation 
involving transfer of data or control 
information between the I/O device and 
the channel subsystem. 

Each I/O operation initiated at the I/O 
device causes one and only one channel 
end for an I/O operation. The channel- 
end condition is not generated when 
programming errors or equipment malfunc- 
tions are detected during initiation of 
the operation. When command chaining 
takes place, only the channel end of the 
last operation of the chain is made 
available to the program. The channel- 
end condition is not made available to 
the program when a chain of commands is 
prematurely concluded because of an 
unusual condition indicated with device 
end or during the initiation of a 
chained command. 

The instant within an I/O operation when 
channel end i s generated depends on the 
operation and the type of device. For 
operations such as writing on magnetic 
tape, the channel-end condition occurs 
when the block has been written. On 
devices that verify the writing, channel 
end may or may not be delayed until 
verification is performed, depending on 
the device. When magnetic tape is being 
read, the channel-end condition occurs 
when the gap on tape reaches the read- 
write head. On devices equipped with 
buffers, such as the IBM 3211 Printer 
Model 1, the channel-end condition 
occurs upon completion of data transfer 
between the channel subsystem and the 
buffer. During control operations, 
channel end i s generated when the 
control information has been transferred 
to the devices, although, for short 
operations, the condition may be delayed 
until completion of the operation. 
Operations that do not cause any data to 
be transferred can provide the channel- 
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end condition during 
sequence. 



the initiation 



Channel end is presented in combination 
with status modifier and unit check by 
means of a special sequence to initiate 
the command-retry procedure. 



Devi ce End 



Device end is indicated (1) when the 
completion of an I/O operation occurs at 
the I/O device, (2) when the device 
signals that a transition from the not- 
ready to the ready state has occurred, 
(3) when the termination of an activity 
has occurred which previously caused a 
response of busy to the channel subsys- 
tem, and (4) when the I/O device signals 
that an asynchronous condition has been 
recognized. Device end normally indi- 
cates that the I/O device has become 
available for use for another operation. 

Each I/O operation initiated at the I/O 
device causes one and only one device 
end for an I/O operation. The device- 
end condition is not generated when any 
programming or equipment malfunction is 
detected during initiation of the opera- 
tion. When command chaining is 
specified and the suspend flag is zero 
in the next CCW, receipt of the device- 
end signal, in the absence of any 
unusual conditions, causes the channel 
subsystem to initiate transfer of the 
next command. When command chaining 
takes place, the only device end made 
available to the program is that of the 
last operation of the chain, unless an 
unusual condition is detected during the 
initiation of a chained command. If an 
unusual condition is detected during the 
initiation of a chained command, the 
subchannel becomes status-pending with 
primary and secondary status, and with 
the SCSW indicating the unusual condi- 
tion without including the device-end 
i ndi cati on. 
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following CCW if command chaining was 
specified in the previous CCW. 

On buffered devices, such as an IBM 3211 
Printer Model 1, the device-end condi- 
tion occurs upon completion of the 
mechanical operation. When device end 
i s generated later than channel end for 
the last I/O operation of a channel 
program, the program may elect to 
request the initiation of another start 
function prior to receiving the device- 
end indication. If the device-end 
indication is solicited and the subchan- 
nel is start-pending for a new start 
function, the device-end indication is 
discarded by the channel subsystem, and 
the pending I/O operation is initiated. 



For control 
generated at 
ation at the 
be completed 
generated or 



operations, device end is 
the completion of the opei — 
device. The operation may 
at the time channel end is 
later. 



When the device makes a transition from 
the not-ready to the ready state, either 
device end or device end, attention, and 
unit exception are indicated. Refer to 
the System Library publication for the 
device to determine which indication is 
gi ven. 



Unit Check 



Unit check indicates that the I/O device 
has detected an unusual condition that 
is detailed by the information available 
to a sense command. Unit check may 
indicate that a programming or an equip- 
ment error has been detected, that the 
not-ready state of the device has 
affected the execution of the command, 
an exceptional condition other 
one identified by unit excep- 
occurred. The unit-check bit 
a summary indication of the 



or that 

than the 

tion has 

provi des 

conditions identified by sense data. 

An error condition causes the unit-check 
indication when it occurs during the 
execution of a command, during some 
activity associated with an I/O opera- 
tion, or when an unusual condition is 
detected that is unrelated to execution 
of an I/O operation. Unless the error 
condition pertains to the activity 
initiated by a command or i s of immedi- 
ate significance to the program, the 
condition does not cause the program to 
be alerted after device end has been 
signaled to the channel subsystem; a 
malfunction may, however, cause the 
device to become not ready. If an error 
condition of immediate significance to 
the program occurs while there is no I/O 
operation in progress, unit check is 
presented together with attention, 
control-unit end, or device end as unso- 
licited alert status. 
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Unit check is indicated when the exist- 
ence of the not-ready state precludes a 
satisfactory execution of the command* 
or when the command* by its nature, 
tests the state of the device. When no 
status condition is pending for the 
addressed device at the control unit, 
the control unit signals unit check when 
a command is transferred to a device in 
the not-ready state. In the case of 
no-operation, the command is rejected, 
and channel end and device end do not 
accompany unit check. 

Unless the command is designed to cause 
unit check, such as rewind and unload on 
magnetic tape, unit check is not indi- 
cated if the command is properly 
executed, even though the device has 
become not ready during or as a result 
of the operation. Similarly, unit check 
is not indicated if the command can be 
executed when the device is in the not- 
ready state. Selection of a device in 
the not-ready state does not cause a 
unit-check indication when the sense 
command is transferred, and when the 
addressed device contains status. 
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Programmi ng Notes 



1. Unit-check status presented either 
in the absence of or accompanied by 
other status indicates only that 
sense information is available to 
the basic sense command. Presenta- 
tion of either channel end and unit 
check or channel end, device end, 
and unit check does not provide any 
indication as to the kind of condi- 
tions encountered by the control 
unit, the state of the I/O device, 
or whether execution of the I/O 
operation ever was initiated even 
though the command may have been 
accepted. Descriptions of these 
conditions are provided in the 
sense information. 

I 2. START SUBCHANNEL, RESUME 
I SUBCHANNEL, HALT SUBCHANNEL, or 
CLEAR SUBCHANNEL may be executed 
for a subchannel whose associated 
device is attached to the same 
control unit that is currently 
holding sense data pertaining to a 
unit-check condition signaled by 
another attached device. The chan- 
nel subsystem ensures that no sense 
data is lost. The performance of 
the function specified by the START 
SUBCHANNEL, RESUME SUBCHANNEL, or 
HALT SUBCHANNEL instruction may be 
delayed, however, until the sense 
data has been cleared from the 
control unit, or it may not take 
place at all, as in the case of 
CLEAR SUBCHANNEL. The sense data 
may be retrieved (or reset) by 
executing START SUBCHANNEL for the 
subchannel that presented unit 
check. Sense information is also 
reset if the execution of CLEAR 
SUBCHANNEL results in a clear 
signal being issued on the channel 
path on which unit check was 
presented, or if the RESET CHANNEL 
PATH instruction is executed, 
designating the channel path on 
which unit check was presented. 



Conclusion of an operation with the 
unit-check indication causes command 
chaining and command retry to be 
suppressed. 

Unit check is presented in combination 
with channel end and status modifier to 
initiate the command-retry procedure. 



Uni t Except i on 



Unit exception is cause 
device detects a condit 
does not occur. Unit ex 
a condition such as r 
tape mark and does not n 
cate an error. During 
I/O operation, unit exc 
one meaning for any pa 
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execution of an 
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The unit-exception condition can be 
generated only when the device is 
executing an I/O operation, or when the 
device is involved with some activity 
associated with an I/O operation and the 
condition is of immediate significance 
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to the program. If the device detects 
during the initiation sequence that the 
operation cannot be executed, unit 
exception is presented and appears with- 
out channel end or device end. Such 
unit status indicates that no action has 
been taken at the device in response to 
the command. If the condition preclud- 
ing normal execution of the operation 
occurs after the command has been 
accepted, unit exception is accompanied 
by channel end, or device end, depending 
on when the condition was detected. Any 
unusual conditions associated with an 
operation, but detected after device end 
has been cleared, are indicated by 
signaling unit exception with attention. 

If the I/O device responds with busy 
status to a command, the generation of 
unit exception is suppressed even when 
execution of that command usually causes 
unit exception to be indicated. 

Concluding an operation with the unit- 
exception indication causes command 
chaining and command retry to be 
suppressed. 

Some I/O devices present unit exception 
accompanied by device end and attention 
whenever the device makes the transition 
from the not-ready to the ready state 
(see the section "Device End" earlier in 
thi s chapter) . 



I SUBCHANNEL-STATUS FIELD 



Subchannel-status conditions are 
detected and indicated in the SCSW by 
the channel subsystem. Except for the 
conditions caused by equipment malfunc- 
tioning, they can occur only while the 
channel subsystem is involved with the 
performance of a halt, resume, or start 
function. The subchannel-status field 
is meaningful whenever the subchannel is 
status-pending with any combination of 
primary, secondary, intermediate, or 
alert status. When the subchannel is 
status-pending with deferred condition 
code 3 indicated, the contents of the 
subchannel-status field are not meaning- 
ful. 



Program-Controlled Interrupti on 



An intermediate interruption condition 
is generated after a CCW with the 
program-controlled- i nterrupti on (PCI ) 
flag set to one becomes the current CCW. 
The I/O interruption due to the PCI flag 
may be delayed an unpredictable amount 
of time because of masking of the inter- 
ruption request or other activity in the 
system. (See the section "Program- 
Controlled Interruption" in Chapter 15, 
"Basic I/O Functions.") 



Detection of the PCI condition does not 
affect the progress of the I/O 
operati on. 



Incorrect Length 



Incorrect length occurs when the number 
of bytes contained in the storage areas 
assigned for the I/O operation is not 
equal to the number of bytes requested 
or offered by the I/O device. Incorrect 
length is indicated for one of the 
following reasons: 

Long Block on Input ? During a read, 
read-backward, or sense operation, the 
device attempted to transfer one or more 
bytes to main storage after the assigned 
main-storage areas were filled. The 
extra bytes have not been placed in main 
storage. The count in the SCSW is zero. 

Long Block on Output ? During a write or 
control operation, the device requested 
one or more bytes from the channel 
subsystem after the assigned main- 
storage areas were exhausted. The count 
in the SCSW is zero. 

Short Block on Input ? The number of 
bytes transferred during a read, read- 
backward, or sense operation is insuffi- 
cient to fill the main-storage areas 
assigned to the operation. The count in 
the SCSW is not zero. 

Short Block on Output ? The device 
terminated a write or control operation 
before all information contained in the 
assigned main-storage areas was trans- 
ferred to the device. The count in the 
SCSW is not zero. 
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Presence of the incorrect-length condi- 
tion suppresses command chaining unless 
the SLI flag in the CCW is one or unless 
the condition occurs in an immediate 
operation when the subchannel is in the 
i ncorrect-length-suppressi on mode. 



Program Check 



Program check occurs when programming 
errors are detected by the channel 
subsystem. The condition can be due to 
the following causes? 
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Invali d CCUI-Address Speci f i cati on » The 
channel-program address (CPA) or the 
transf er-i n-channel command does not 
designate the CCW on a doubleword bound- 
ary, or bit of the CPA or bit 32 of a 
format-1 CCW specifying the transf ei — 
i n-channel command is not zero. 



Address 



Invalid CCW 

subsystem has 

from a main-storage 

not available. An invalid 



The 



channel 

attempted to fetch a CCW 

location which is 

CCW address 



can occur because the program has desig- 
nated an invalid address in the CPA or 
in the transf ei — i n-channel command or 
because, on chaining, the channel 
subsystem attempts to fetch a CCW from 
an unavailable location. A main-storage 
location is unavailable either because 
the absolute address does not correspond 
to a physical location or because a 
format-0 CCW has been specified in the 
ORB and the absolute address designates 
a location greater than 16,777,215. 

Invalid Command Code : There are zeros 
in the four rightmost bit positions of 
the command code in the CCW designated 
by the CPA or in a CCW fetched on 
command chaining. The command code is 
not tested for validity during data 
chaini ng. 

Invali d Count , Format 0.: A CCW, which 
is other than a CCW specifying transfer 
in channel, contains zeros in bit posi- 
tions 48-63. 

Invalid Count , Format 1.: A CCW that 
specifies data chaining or a CCW fetched 
while data chaining contains zeros in 
bit positions 16-31. 

Invali d IDAW-Address Speci f i cati on : 
Indirect data addressing is specified, 
and the contents of the data-address 
field in the CCW do not designate the 
first IDAW on an integral word boundary; 
that is, bits 30-31 (format 0) or bits 
62-63 (format 1) are not zeros. 
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invalid data address is recognized by 
the channel subsystem. 

1. Use of the data address has caused 
the channel subsystem to attempt to 
wrap from the maximum storage 
address to zero. 

2. Use of the data address has caused 
the channel subsystem to attempt to 
wrap from zero to the maximum stoi — 
age address during a read-backward 
operati on. 

3. The channel subsystem has attempted 
to transfer data to or from a stoi — 
age location which is either not 
available or is outside the 
addressing range specified by SET 
ADDRESS LIMIT and the limit mode at 
the subchannel. 

An invalid data address can occur 
because the program has designated an 
invalid address in the CCW or in an 
IDAW, or because an address-limit 
violation is detected when the address 
exceeds the boundary address specified 
by SET ADDRESS LIMIT, or because the 
channel subsystem, on sequentially 
accessing storage, attempted to access 
an unavailable location. A main-storage 
location is unavailable either because 
the absolute address does not correspond 
to a physical location or because 
format-0 CCWs have been specified in the 
ORB, indirect data addressing has not 
been specified, and the absolute address 
obtained by sequentially accessing stoi — 
age designates a location greater than 
16,777,215. The boundary condition 
specified by SET ADDRESS LIMIT is under 
the control of the limit mode at the 
subchannel . 



Note : The maximum stora 
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Invalid Data Address : When one of the 
following conditions is detected, an 



Invalid IDAW Specif i cation : Bit of 
the IDAW is not zero, or the second or a 
subsequent IDAW does not designate the 
location of the beginning or, for read- 
backward operations, the location of the 
ending byte of a 2K-byte block. 

Invalid CCW , Format 0.: A CCW other than 
a CCW specifying transfer in channel 
does not contain a zero in bit position 
39. 

Invalid CCW, Format 1.: A CCW other than 
a CCW specifying transfer in channel 
does not contain a zero in bit position 
15, or a CCW specifying transfer in 
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channel does not contain 
positions 0-3 and 8-31. 



zeros in bit 



Invalid Suspend Flag : A format-0 or 
format-1 CCW fetched during data chain- 
ing, other than a CCW specifying trans- 
fer in channel, does not contain a zero 
in bit position 38 or 14, respectively. 
A CCW other than a CCW specifying trans- 
fer in channel does not contain a zero 
in bit position 38 for a format-0 CCW or 
bit position 14 for a format-1 CCW, and 
suspend control was not specified in the 
ORB (bit 4 of word 1). 

Invalid ORB Format : Word 1 of the ORB 
does not contain zeros in bit positions 
5-7, 13-15, and 25-31. If the incor- 
rect- length- i ndicati on- suppress i on fa- 
cility is not installed, then bit 24 of 
word 1 of the ORB must also be zero. 

Invalid Sequence : The channel subsystem 
has fetched two successive CCWs both of 
which specify transfer in channel, or, 
depending on the model, a sequence of 
256 or more CCWs with command chaining 
specified was executed by the channel 
subsystem and did not result in the 
transfer of any data to or from an I/O 
devi ce. 

Detection of the program-check condition 
during the initiation of an operation at 
the device causes the operation to be 
suppressed and the subchannel to be made 
status-pending with primary, secondary, 
and alert status. When the condition is 
detected after the I/O operation has 
been initiated at the device, the device 
is signaled to conclude the operation 
the device requests or 
of data or status. In 
the subchannel i s made 
as a function of the 
from the device. The 
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this situation, 
status-pendi ng 
status received 



program-check 
chaining and 
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condi tion 
command 



causer, 
retry 



command 
to be 



is signaled to conclude the operation 
the next time it requests or offers a 
byte of data or status. However, if an 
access violation occurs when the channel 
subsystem is in the process of fetching 
either a new IDAW or a new CCW while 
data chaining and if the device signals 
the channel-end condition before trans- 
ferring any data designated by the new 
CCW or IDAW, then the status is 
accepted, and the subchannel becomes 
status-pending with primary and alert 
status and with protection check indi- 
cated. Other indications may accompany 
the protection-check indication as a 
function of the operation specified by 
the CCW, the status received from the 
device, and the current state of the 
subchannel. The protection-check condi- 
tion causes command chaining and command 
retry to be suppressed. 



Channel-Data Check 



Channel-data check indicates that an 
uncorrected storage error has been 
detected in regard to data, contained in 
main storage, that is currently used in 
the execution of an I/O operation. The 
condition may be indicated when 
detected, even if the data is not used 
when prefetched. Channel-data check is 
indicated when data or the associated 
key has an invalid checking-block code 
(CBC) in main storage when that data is 
referenced by the channel subsystem. 

On an input operation, when the channel 
subsystem attempts to store less than a 
complete checking block, and invalid CBC 
is detected on the checking block in 
storage, the contents of the location 
remain unchanged, with invalid CBC. On 
an output operation, whenever channel- 
data check is indicated, no bytes from 
the checking block with invalid CBC are 
transferred to the device. 



Protecti on Check 



Protection check occurs when the channel 
subsystem attempts a storage access that 
is prohibited by the protection mech- 
anism. Protection applies to the fetch- 
ing of CCWs, IDAWs, and output data, and 
to the storing of input data. The 
subchannel key provided in the ORB is 
used as the access key for storage 
accesses associated with an I/O opera- 
tion. 

Detection of the protection-check condi- 
tion during the fetching of the first 
CCW or IDAW causes the operation to be 
suppressed and the subchannel to be made 
status-pending with primary, secondary, 
and alert status. When protection check 
is detected after the I/O operation has 
been initiated at the device, the device 



During a storage access, the maximum 
number of bytes that can be transferred 
is model-dependent. If a channel-data- 
check condition is recognized during 
that storage access, the number of bytes 
transferred to or from storage may not 
be detectable by the channel subsystem. 
Consequently, the number of bytes trans- 
ferred to or from storage may not be 
correctly reflected by the residual 
count. However, the residual count that 
is stored in the SCSW, when used in 
conjunction with the storage-access code 
and the CCW address, designates a byte 
location within the page in which the 
channel-data-check condition was recog- 
n i zed . 

A condition indicated as channel-data 
check causes the current operation, if 
any, to be terminated. The subchannel 
becomes status-pending with primary and 
alert status or with primary, secondary, 
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and alert status as a function of the 
status received from the device. The 
count and address fields of the SCSW 
stored by TEST SUBCHANNEL pertain to the 
operation terminated. The extended- 
status-word-format bit is one, and 
subchannel-logout information is stored 
in the ESW when TEST SUBCHANNEL is 
executed. 

Whenever the channel-data-check condi- 
tion pertains to prefetched data, the 
fai li ng-storage-address-vali di ty flag 
(bit 6 of the ERW) is one. An absolute 
address of a location within the check- 
ing block for which the channel-data- 
check condition is generated is stored 
in the failing-storage-address field in 
word 2 of the ESW. 



Uncorrectable 
detected on 
subchannel i 
operation to 
ation at the 
subchannel i s 
primary, sec 
with channel- 
with the fail 
in word 2 of 



storage or key errors 

prefetched data while the 

s start-pending cause the 

be canceled before initi- 

device. In this case, the 

made status-pending with 
ondary, and alert status, 
data check indicated, and 
ing-storage address stored 
the ESW. 



Whenever channel-data check is 
indicated, no measurement data for the 
subchannel is stored. 



Channel -Control Check 



Channel-control check is caused by any 
machine malfunction affecting channel- 
subsystem controls. The condition 
includes invalid CBC on a CCW, an IDAW, 
or the respective associated key. The 
condition may be indicated when an 
invalid CBC is detected on a prefetched 
CCW, IDAW, or the respective associated 
key, even if that CCW or IDAW is not 
used. 

Channel-control check may also indicate 
that an error has been detected in the 
information transferred to or from main 
storage during an I/O operation. Howev- 
er, when this condition is detected, the 
error has occurred inboard of the chan- 
nel path: in the channel subsystem or 
in the channel path between the channel 
subsystem and main storage. 

Detection of the channel-control-check 
condition causes the current operation, 
if any, to be terminated immediately. 
The subchannel is made status-pending 
with primary and alert status or with 
primary, secondary, and alert status as 
a function of the type of termination, 
the current subchannel state, and the 
device status presented, if any. The 
count and data-address fields of the 
SCSW stored by TEST SUBCHANNEL pertain 
to the operation terminated. The 
extended-status-word-format bit is one 



and subchannel-logout information is 
stored in the ESW when TEST SUBCHANNEL 
is executed. 

Whenever the channel-control-check 
condition pertains to an invalid CBC 
detected on a prefetched CCW, a 
prefetched IDAW, or the key associated 
with the prefetched CCW or the 
prefetched IDAW, an extended-report word 
containing bit 6 set to one and the 
failing-storage address is stored in the 
ESW when TEST SUBCHANNEL is executed. 

Channel-control-check conditions en- 
countered while prefetching when the 
subchannel is start-pending cause the 
operation to be canceled before initi- 
ation at the device. In this case, the 
subchannel is made status-pending with 
primary, secondary, and alert status, 
with channel-control check indicated, 
and with the failing-storage address 
stored in the extended-status word. 
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If a subchannel is start-pending or 
resume-pending and the channel subsystem 
encounters a channel-control-check 
condition while performing the start 
function for that subchannel, the 
subchannel remains start-pending or 
resume-pending unless the channel 
subsystem can determine that the first 
command was accepted. The subchannel 
remains start-pending or resume-pending 
even if the channel subsystem was 
attempting to initiate the I/O operation 
for the first command and is unable to 
determine if the command was accepted. 
If the channel subsystem is unable to 
determine whether the first command was 
accepted, the subchannel is made 
status-pending with at least alert and 
primary status. 

In some situations in which a channel- 
subsystem malfunction exists, the 
channel-control-check condition may be 
reported as a machine-check condition. 

Whenever channel-control check is indi- 
cated, no measurement data for the 
subchannel is stored. 



Programmi ng Note 



If the status-control field of the SCSW 
indicates that the subchannel is 
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status-pending with alert status but the 
field-validity flags of the SCSW indi- 
cate that the device-status field is not 
usable for erroi — recovery purposes, the 
program should assume that the inter- 
face-control-check condition occurred 
while the channel subsystem was accept- 
ing alert status from the device and 
take the appropriate action for alert 
status, even though the status itself 
has been lost. 



Interface-Control Check 



Interface-control check indicates that 
an invalid signal has occurred on the 
channel path. The condition is detected 
by the channel subsystem and usually 
indicates malfunctioning of an I/O 
device. Interface-control check can 
occur for the following reasons: 

1. A data or status byte received from 
a device while the subchannel is 
subchannel-and-devi ce-acti ve or 
device-active has an invalid 
checking-block code. 

2. The status byte received from a 
device while the subchannel is 
idle, start-pending, suspended, or 
halt-pending has an invalid 
checking-block code. 

3. A device responded with an address 
other than the address designated 
by the channel subsystem during 
initiation of an operation. 

4. During command chaining, the device 
appeared not operational. 

5. A signal from an I/O device either 
did not occur or occurred at an 
invalid time or had an invalid 
durati on. 

6. The channel subsystem recognized 
the I/O-error-alert condition (see 
the discussion of I/0-error alert 
in the section "Extended-Status 
Format 0" later in this chapter). 

7. ESW bit 26, device-status check, is 
set to one. 

Detection of the interface-control-check 
condition causes the current operation, 
if any, to be terminated immediately, 
and the subchannel is made status- 
pending with alert status, primary and 
alert status, secondary and alert 
status, or primary, secondary, and alert 
status as a function of the type of 
termination, the current subchannel 
state, and the device status presented, 
if any. The extended-status-word-format 
bit is one and subchannel-logout infoi — 
mation is stored in the ESW when TEST 
SUBCHANNEL is executed. 



If a subchannel is halt-pending and the 
channel subsystem encounters an 
interface-control-check condition while 
performing the halt function for that 
subchannel, the subchannel remains 
halt-pending unless the channel subsys- 
tem can determine that the halt signal 
was issued. The subchannel remains 
halt-pending even if the channel subsys- 
tem was attempting to issue the halt 
signal and is unable to determine if the 
halt signal was issued. 

If a subchannel is start-pending or 
resume-pending and the channel subsystem 
encounters an interface-control-check 
condition while performing the start 
function for that subchannel, the 
subchannel remains start-pending or 
resume-pending unless the channel 
subsystem can determine that the first 
command was accepted. The subchannel 
remains start-pending or resume-pending 
even if the channel subsystem was 
attempting to initiate the I/O operation 
for the first command and is unable to 
determine if the command was accepted. 
If the channel subsystem is unable to 
determine whether the first command was 
accepted, the subchannel i s made 
status-pending with at least alert and 
primary status. 

If, while initiating a signaling 
sequence with the channel subsystem for 
the purpose of presenting status or 
transferring data, the device presents 
an address with invalid CBC, the error 
condition is not made available to the 
program since the identity of the device 
and associated subchannel are unknown. 

Whenever interface-control check is 
indicated, no measurement data for the 
subchannel is stored. 



Proqrammi nq Note 



If the status-control field of the SCSW 
indicates that the subchannel is 
status-pending with alert status but the 
field-validity flags of the SCSW indi- 
cate that the device-status field is not 
usable for erroi — recovery purposes, the 
program should assume that the 
i nt erf ace-control -check condi ti on 
occurred while the channel subsystem was 
accepting alert status from the device 
and take the appropriate action for 
alert status, even though the status 
itself has been lost. 



Chaining Check 



Chaining check is caused by channel- 
subsystem overrun during data chaining 
on input operations. The condition 
occurs when the I/O-data rate is too 
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high for the particular resolution of 
data addresses. Chaining check cannot 
occur on output operations. 

Detection of the chai ni ng-check condi- 
tion causes the I/O device to be 
signaled to conclude the operation. It 
causes command chaining to be 
suppressed. 



upon existing conditions (see the figure 
"CCW Address as Function of Subchannel 
State"), indicates the number of bytes 
transferred to or from the area desig- 
nated by the CCW. The count field is 
meaningful whenever the subchannel is 
status-pending with primary status which 
consists of either (1) device status 
only or (2) device status together with 
subchannel status of incorrect length 
only, PCI only, or both. 



COUNT FIELD 



Bits 16-31 of word 2 contain the resi- 
dual count. The count is to be used in 
conjunction with the original count 
specified in the last CCW and, depending 



In the figure "Contents of Count Field 
in the SCSW," the contents of the count 
field are listed for all cases where the 
subchannel is either start-pending, 
subchannel-and-devi ce-acti ve, devi ce- 
active, suspended, or status-pending. 
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Subchannel State 1 


Count 


Start-pending (UUUUO/AIPSX) 2 


Not 


meaningful 3 




Start-pending and status- 
pending (10YY1/AIPSX) 2 


Not 


meani ngful 3 




Start-pending and status- 
pending (00111/AIPSX) 
because the device appeared 
not operational on all paths 2 


Not 


meani ngful 5 




Start-pending and device- 
active (UUUUO/AIPSX) 2 


Not 


meaningful 3 




Suspended (YYYYY/AIPSX) 2 


Not 


meaningful 3 




Subchannel-and-devi ce-acti ve 
(UUUUO/AIPSX) 2 


Not 


meaningful 3 




Device-active (UUUUO/AIPSX) 


Not 


meaningful 3 




Status-pending (01001/AIPSX) 
because of program-controlled- 
interruption condition or 
initial-status interruption 


Not 


meani ngful 3 




Status-pending (1Y1Y1/AIPSX) ; 
termination occurred because 
of: 2 








Program check 
Protection check 
Chaining check 
Channel-control check 
Interface control check 
Channel-data check 


Not 
Not 
Not 
See 
Not 
See 


meaningful 3 
meaningful 3 
meani ngful 3 
note 1 
meaningful 3 
note 2 




Status-pending (YY1Y1/AIPSX) ; 
termination occurred under 
count control 2 


Correct 




Status-pending (Y0011/AIPSX) 2 


Not 


meaningful 3 




Status-pending (1Y1Y1/AIPSX) 2 


Correct; residual count of 
last used CCU 




Status-pending (1Y111/AIPSX) ; 
command chaining suppressed 
because of alert status 2 


Correct; residual count of 
last used CCW 




Status-pending (YYYY1/AIPSX); 
after termination by HALT 
SUBCHANNEL 2 


Unpredi ctable 




Status-pending (00001/AIPSX) ; 
after termination by CLEAR 
SUBCHANNEL 


Not 


meaningful 3 




Status-pending (YY1Y1/AIPSX) ; 
operation completed normally 
at the subchannel 2 


Correct; indicates the resi 
ual count 


d- 



Contents of Count Field in the SCSW (Part 1 of 2) 
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Subchannel State 1 



Count 



Status-pending ( 1Y111/AIPSX) ; 
command chaining terminated 
because of alert status 2 

Status-pending ( 10001/AIPSX) 
because of alert status 



Correct; original count of CCW 
specifying the new I/O oper- 
ati on 

Not meaningful 3 



Explanati on : 



Notes: 



In situations where more than a single condition exists 
because of, for example, alert status that is described 
by program check and unit check, the entry appearing 
first in the table takes precedence. 

The meaning of the notation in this column is as 
follows: 

A Alert status 

I Intermediate status 

P Primary status 

S Secondary status 

X Status-pending 

The allowed combination of status-control-bit settings 
is shown to the left of the "/" symbol. 

Bit settings are specified as follows: 

Corresponding condition is not indicated. 

1 Corresponding condition is indicated. 

U Unpredictable. The corresponding condition is 

not meaningful when the subchannel is not 

status-pendi ng. 
Y Corresponding condition is not significant and 

is indicated as a function of the subchannel 

state. 

The subchannel may also be resume-pending. 

The contents of the count field are not meaningful 
because the count field is not valid when the SCSW is 
stored and the subchannel is in the given state. 



The count is unpredictable unless IDAW check is in- 
dicated, in which case the count may not correctly re- 
flect the number of bytes transferred to or from main 
storage but will (when used in conjunction with the 
CCW address) designate a byte location within the page 
in which the channel-control-check condition was recog- 
ni zed. 



During a storage access, the maximum number 
that can be stored by a channel subsystem i 
dependent. If a channel-data-check conditi 
m" zed during that access, the number of byt 
red to or from storage may not be detectabl 
channel subsystem. Consequently, the numbe 
transferred to or from storage may not be c 
reflected by the residual count. However, 
count that is stored when used in conjuncti 
storage-access code and the CCW address des 
byte location within the page in which the 
data-check condition was recognized. 



of bytes 
s model- 
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Contents of Count Field in the SCSW (Part 2 of 2) 
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EXTENDED-STATUS WORD 



The extended-status word (ESW) provides 
additional information to the program 
about the subchannel and its associated 
device. The ESW is placed in words 3-7 
of the IRB designated by the second 
operand of TEST SUBCHANNEL when TEST 
SUBCHANNEL is executed and the subchan- 
nel designated is operational. If the 
subchannel is status-pending or status- 
pending with any combination of primary, 
secondary, intermediate, or alert status 
(except as noted in the next paragraph) 
when TEST SUBCHANNEL is executed, the 
ESW may have one of the following types 
of extended-status formats: 

Format 0: Subchannel logout in 

word 0, an ERW in word 1, a 

failing-storage address or zeros in 
word 2, and zeros in words 3-4 



status as defined in the figure 
"Relationship between Subchannel-Logout 
Data and SCSW Bits." In this case, 
subchannel-logout information and an ERW 
are stored in the extended-status word. 
Subchannel logout provides detailed 
model-independent information, relating 
to a subchannel and describing equipment 
errors detected by the channel 
subsystem. The information is provided 
to aid the recovery of an I/O operation, 
a device, or both. Whenever subchannel 
logout is provided, the error conditions 
relate only to the subchannel reporting 
the error. If I/O operations involving 
other subchannels have been affected by 
the error condition, those subchannels 
also provide similar subchannel-logout 
information. An extended-report word 
provides additional information relating 
to the cause of the malfunction. 

A format-0 ESW has this format: 



Format 1: Zeros in bytes and 2-3 
of word 0, the LPUM in byte 1 of 
word 0, and zeros in words 1-4 

Format 2: Zeros in byte 0, the 
LPUM in byte 1, and the device- 
connect time in bytes 2-3 of word 
0; zeros in words 1-4 

Format 3: Zeros in byte 0, the 
LPUM in byte 1, and unpredictable 
values in bytes 2 and 3 of word 0; 
zeros in words 1-4 



Subchannel Logout 



Extended-Report Word 



Failing-Storage Address 



Zeros 



Bytes 0-3 of word of the ESW contain 
unpredictable values if any of the 
following conditions is met: 



The subchannel is 
i ng. 



not status-pend- 



The subchannel is status-pending 
alone, and the extended-status- 
word-format bit is zero. 



Subchannel Logout 



The subchannel logout has this format 






ESF 


LPUM 





FVF 


SA 


TC 


D 


E 


A 


SC 



1 



16 



22 24 26 



31 



3. The subchannel is status-pending 
with intermediate status alone for 
other than the intermediate intei — 
ruption condition due to 
suspensi on. 

The type of extended-status format 
stored depends upon conditions existing 
at the subchannel at the time TEST 
SUBCHANNEL is executed. The conditions 
under which each of the types of formats 
is stored are described in the remainder 
of this section. 



EXTENDED-STATUS FORMAT 



The ESW stored by TEST SUBCHANNEL is a 
format-0 ESW when the extended-status- 
word-format bit (bit 5, word of the 
SCSW) is one and the subchannel is 
status-pending with any combination of 



Extended-Status Flags ( ESF ) : Any of the 
bits 1-7, when one, specify that an 
error-check condition has been detected 
by the channel subsystem. The following 
indications are provided in the ESF 
field: 

!♦ Key Check . Bit 1, when one, indi- 
cates that the channel subsystem, 
when accessing data, when attempt- 
ing to update the measurement 
block, or when attempting to fetch 
either a CCW or an IDAW, has 
detected an invalid checking-block 
code (CBC) on the associated stoi — 
age key. The channel-data-check 
bit (bit 12 of word 2 of the SCSW), 
the measurement-block data-check 
bit (bit 3 of word of the ESW), 
the CCW-check bit (bit 5 of word 
of the ESW), or the IDAW-check bit 
(bit 6 of word of the ESW) iden- 
tifies the source of the key error. 
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4. 



Note : This condition may be indi- 
cated to the program when an inval- 
id checking-block code on a key is 
detected but the data, CCW, or IDAW 
is not used when prefetching. In 
this case, the failing-storage- 
address-validity bit (bit 6 of the 
ERW) is one, indicating that an 
absolute address of a location 
within the invalid CBC is stored in 
word 2 of the ESW. 

Measurement-Block Program Check . 
Bit 2, when one, indicates that the 
channel subsystem, in attempting to 
update the measurement block, has 
detected an invalid absolute 
address when combining the 
measurement-block origin with the 
measurement-block index for this 
subchannel . 

Measurement-Block Data Check . Bit 
3, when one, indicates that a 
malfunction has been detected 
involving the data of the measure- 
ment block in main storage. (See 
the section "Measurement Block" in 
Chapter 17, "I/O Support 
Functions.") Measurement-block data 
check is indicated when the meas- 
urement block is updated and an 
invalid checking-block code (CBC) 
is detected on the storage used to 
contain the measurement data or on 
the associated key. When invalid 
CBC on the associated key is 
detected, the key-check bit, bit 1 
of the ESF field, is also stored as 
one. 

Measurement-Block Protection Check . 
Bit 4, when one, indicates that the 
channel subsystem, when attempting 
to update the measurement block, 
has been prohibited from accessing 
the measurement block because the 
storage key does not match the 
measurement-block key (see the 
section "Measurement Block" in 
Chapter 17, "I/O Support 
Functions"). The key provided by 
SET CHANNEL MONITOR is used for the 
access of storage associated with 
measurement-block-update operati ons 
(see the section "SET CHANNEL MONI- 
TOR" in Chapter 14, "I/O 
Instructions") . 



Note : Wheneve 
measurement-chec 
2-4, is indicate 
system sets the 
ment-block-updat 
zero, disabling 
measurement data 
(see the sectio 
Control Word" in 
I/O Functions"). 



r any of the 
k conditions, bits 
d, the channel sub- 
subchannel measure- 
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the storing of 
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n "Path-Management- 
Chapter 15, "Basic 



5. 



CCW Check . Bit 5, when one, indi- 
cates that an invalid CBC on the 
contents of the CCW or its associ- 
ated key has been detected. When 



either of these conditions is 
detected, the I/O operation is 
terminated, the subchannel becomes 
status-pending with primary and 
alert status, the extended-status- 
word-format bit in the SCSW is 
stored as one, and channel-control 
check is indicated in the 
subchannel-status field. The 
subchannel also becomes status- 
pending with secondary status as a 
function of the type of termination 
or status received from the device. 
When invalid CBC on the associated 
key is detected, the key-check bit, 
bit 1 of the ESF field, is also 
stored as one. 

Note : This condition may be indi- 
cated to the program when an inval- 
id checking-block code on the 
contents of a prefetched CCW is 
detected but the CCW is not used. 
In this case, the failing-storage- 
address-validity bit (bit 6 of the 
ERW) is one, indicating that an 
absolute address of a location 
within the invalid CBC is stored in 
word 2 of the ESW. 

6. IDAW Check . Bit 6, when one, indi- 
cates that an invalid CBC on the 
contents of an IDAW or its associ- 
ated key has been detected. When 
either of these conditions is 
detected, the I/O operation is 
terminated with the device, the 
subchannel becomes status-pending 
with primary and alert status, the 
extended-status-word-format bit in 
the SCSW is one, and channel- 
control check is indicated in the 
subchannel-status field. The 
subchannel also becomes status- 
pending with secondary status as a 
function of the type of termination 
or status received from the device. 
When invalid CBC on the associated 
key is detected, the key-check bit, 
bit 1 of the ESF field, is also 
one. 

Note : This condition may be indi- 
cated to the program when an inval- 
id checking-block code on the 
contents of a prefetched IDAW is 
detected but the IDAW is not used. 
In this case, the failing-storage- 
address-validity bit (bit 6 of the 
ERW) is one, indicating that an 
absolute address of a location 
within the invalid CBC is stored in 
word 2 of the ESW. Detection of a 
channel-data-check condition does 
not cause the CCW-check and IDAW- 
check bits to be stored as ones. 

7. Reserved . Bit 7 is stored as zero. 

Last-Path-Used Mask ( LPUM ): Bits 8-15 
indicate the channel path that was last 
used for communicating or transferring 
information between the channel subsys- 
tem and the device. The bit correspond- 
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ing to the channel path in use is set 
whenever one of the following occurs: 

1. The first command of a start- 
subchannel function is accepted by 
the device (see the section "Activ- 
ity Control" earlier in this chap- 
ter). 

2. The device and channel subsystem 
are actively communicating when the 
channel subsystem performs the 
suspend function for the channel 
program in execution. 

3. The channel subsystem accepts 
status from the device that is 
recognized as an interruption 
condition* or a condition has been 
recognized that suppresses command 
chaining (see the section "Intel — 
ruption Conditions" earlier in this 
chapter) . 

4. The channel subsystem recognizes an 
i nt erf ace- control -check condi t i on 
(see the section "Interface-Control 
Check" earlier in this chapter), 
and no subchannel-logout informa- 
tion is currently present at the 
subchannel . 



The LPUM fie 
setting and 
contains in 
formats 0-3 
Status Word 
and the 
subchannel-1 
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Field-Validity Flags (FVF); Bits 17-21 
indicate the validity of the information 
stored in the corresponding fields of 
either the SCSW or the extended-status 
word. When the validity bit is one, the 
corresponding field has been stored and 
is usable for recovery purposes. When 
the validity bit is zero, tha corre- 
sponding field is not usable. 



This bit-significant fie 
when channel-data check, 
check, or interface-con 
indicated in the SCSW 
checks are not indicated, 
well as the termina 
sequence-code fields, ha 
Further, when these check 
cated, the last-path-use 
status, and CCW-address 
valid. The fields ar 
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thi s f i eld, as 
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d-mask, device- 
fields are all 
e defined as 



17 Last-path-used mask 

18 Termination code 

19 Sequence code 

20 Device status 

21 CCW address 



Storage-Access Code (SA> : Bits 22-23 
indicate the type of storage access that 
was being performed by the channel 
subsystem at the time of error. It 
pertains only to the access of storage 
for the purpose of fetching or storing 
data during execution of an I/O opera- 
tion. This encoded field has meaning 
only when channel-data check, channel- 
control check, or interface-control 
check is indicated in the subchannel 
status. The access-code assignments are 
as follows: 

00 Access type unknown 

01 Read 

10 Write 

11 Read backward 

Termination Code (J_C) : Bits 24-25 indi- 
cate the type of termination that has 
occurred. This encoded field has mean- 
ing only when channel-data check, 
channel-control check, or interface- 
control check is indicated in the SCSW. 
The types of termination are as follows: 

00 Halt signal issued 

01 Stop, stack, or normal termi- 
nati on 

10 Clear signal issued 

11 Reserved 

When at least one channel check is indi- 
cated in the SCSW but the termination- 
code-field-validity flag is zero, it is 
unpredictable which, if any, termination 
has been signaled to the device. If 
more than one channel-check condition is 
indicated in the SCSW, the device may 
have been signaled one or more termi- 
nation codes that are the same or 
different. In this situation, if the 
termination-code-field-validity flag is 
one, the termination code indicates the 
most severe of the terminations signaled 
to the device. The termination codes, 
in order of increasing severity, are: 
stop, stack, or normal termination (01); 
halt signal issued (00); and clear 
signal issued (10). 

Devi ce-Status Check ( D) : When the 
status-verification facility is 
installed, bit 26, when one, indicates 
that the subchannel logout in the ESW 
resulted from the channel subsystem 
detecting device status that had valid 
CBC but that contained a combination of 
bits that was inappropriate when the 
status byte was presented to the channel 
subsystem. When the device-status-check 
bit is one, the interface-control-check 
status bit is set to one. If, addi- 
tionally, bit 20 of the subchannel- 
logout field has been stored as one, 
then the status byte in error has been 
stored in the device-status field of the 
SCSW. If the status-verification facil- 
ity is not installed, bit 26 is stored 
as zero. 

Seconda ry Error (E) : Bit 27, when one, 
indicates that a malfunction of a system 



16-38 370-XA Principles of Operation 



component which 
directly relate 
i ng subchannel 
occurred, 
occurrence, the 
subchannel and 
was affected a 
to be set sta 
channel-control 
control check. 



may or may not 
d to any activi 
s or I/O de 
Subsequent t 

activity relat 
the associated 
nd caused the 
tus-pending wi 
check or 



have been 
ty involv- 
vices has 
o thi s 
ed to thi s 
I/O device 
subchannel 
th either 
interface- 



I/Q-Error 
i ndi cates 
ESW resul 
error ale 
i ndi cates 
device ha 
must be r 
tern. T 
response, 
except as 
graph, ca 
be set 
( logout) 
ESW. 



Alert (A): 
that subcha 
ted from the 
rt. The I/O 

that the 
s detected 
eported to 
he channel 
i ssues a 
descri bed 
uses interfa 
and exten 
i nf ormat i on 



Bit 28, 
nnel log 

si gnali 
-erroi — al 

control 
a malfun 
the chann 
subsy 
clear si 
i n the n 
ce-contro 
ded-statu 
to be sto 



when one, 
out in the 
ng of 1/0- 
ert signal 
unit or 
ction that 
el subsys- 
stem, in 
gnal and, 
ext para- 
1 check to 
s-f ormat-0 
red i n the 



When I/0-error alert is signaled and the 
subchannel has previously been set disa- 
bled or no subchannel is associated with 
the device, the clear signal is issued 
to the device, and the I/0-erroi — alert 
indication is ignored by the channel 
subsystem. 

Sequence Code (SC) : Bits 29-31 identify 
the I/O sequence in progress at the time 
of error. The sequence code pertains 
only to I/O operations initiated by 
execution of START SUBCHANNEL or RESUME 
SUBCHANNEL. This encoded field has 
meaning only when channel-data check, 
channel-control check, or interface- 
control check is indicated in the SCSW. 

The sequence-code assignments are: 

000 Reserved 

001 A nonzero command byte has been 
sent by the channel subsystem, but 
device status has not yet been 
analyzed by the channel subsystem. 
This code is set during the initi- 
ation sequence. 

010 The command has been accepted by 
the device, but no data has been 
transferred. This code is set 
during the initiation sequence, if 
the initial status is (1) channel 
end alone, (2) channel end and 
device end, (3) channel end, 
device end, and status modifier, 
or (4) all zeros. 

011 At least one byte of data has been 
transferred between the channel 
subsystem and the device. This 



code may be used when the channel 
path is in an idle or polling 
state. 

100 The command in the current CCW 
(1) has not yet been sent to the 
device, (2) was sent but not 
accepted by the device, or (3) was 
sent and accepted but command- 
retry status was presented. This 
code i s set when one of the 
following conditions occurs: 

1 . When the command address i s 
updated during command chain- 
ing or during the initiation 
of a start function or resume 
function at the device 

2. When, during the initiation 
sequence, the status includes 
attention, control-unit end, 
unit check, unit exception, 
busy, status modifier (without 
channel end and device end), 
or device end (without channel 
end) 

3. When command retry is signaled 

4 . When the channel subsystem 
interrogates the device in the 
process of clearing an intei — 
ruption condition 

5. When the channel subsystem 
signals the conclusion of the 
chain of operations to the 
device during command chaining 
while performing the suspend 
functi on 

101 The command in the current CCW has 
been accepted, but data transfer 
is unpredictable. This code 
applies from the time a device is 
logically connected to a channel 
path until the time it is deter- 
mined that a new sequence code 
applies. This code may also be 
used when the channel subsystem 
places a channel path in the poll- 
ing or idle state and it is 
impossible to determine that code 
010 or 011 applies. It may also 
be used at other times when a 
channel path cannot distinguish 
between code 010 or 011. 

110 Reserved 

111 Reserved 

The figure "Relationship between 
Subchannel-Logout Data and SCSW Bits" 
defines the relationship between indi- 
cations provided as subchannel-logout 
data and the appropriate SCSW bits. 
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Subchannel-Logout Condition Indicated 


Logout Condition 

for SCSW 

Indication of x 


CDC 


CCC 


IFCC 


Key check 


V 


V 


- 


Measurement-block-program check 2 


- 


- 


- 


Measurement-block-data check 2 


- 


- 


- 


Measurement-block-protect i on check 2 


- 


- 


- 


CCU check 


- 


V 


- 


IDAW check 


- 


V 


- 


Last-path-used mask 3 


V 


V 


V 


Field-validity flags 


V 


V 


V 


Termination code 3 


V 


V 


V 


Device-status check 


- 


- 


V 


Secondary error 


- 


V 


V 


I/0-error alert 


- 


- 


V 


Sequence code 3 


V 


V 


V 


Explanat i on: 




No relationship. 

1 When more than one SCSW indication i 
subchannel-logout conditions that an 
logical OR for each of the respectiv 

2 Only one measurement-block check may 
a specific subchannel logout. 

3 This field has a field-validity flag 
CCC Channel-control check. 

CDC Channel-data check. 
IFCC Interface-control check. 
V Bit setting valid. 


5 signaled, the 
s valid are the 
a SCSW indications. 

be indicated in 



Relationship between Subchannel-Logout Data and SCSW Bits 
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Ex tended- Report Word 



The extended-report word provides infor- 
mation to the program describing specif- 
ic conditions that may exist at the 
device, subchannel, or channel 
subsystem. The extended-report word is 
stored when the extended-status-word- 
format bit (bit 5, word of the SCSW) 
is one. 

The ERW has this format: 



a. The primary-status bit (bit 29, 
word of the SCSW) alone, or 

b. The primary-status bit and 
other status-control bits, or 

c. The intermediate-status bit 
(bit 28, word of the SCSW) 
and the suspended bit (bit 26, 
word of the SCSW). 

At least one of the following 
conditions is indicated: 



000000 F 00000000 00000000 00000000 



Fai li ng-Storage-Address-Val i di tv 
( F) : Bit 6, when one, indicate 
the channel subsystem has detec 
invalid CBC on a CCW, a data addr 
1DAW, or the respective associa 
and has stored in word 2 of the 
absolute address of a location 
the invalid CBC. When an ERW is 
with bit 6 set to zero, the 
subsystem has not detected an 
CBC while prefetching data, a CCW 
IDAW, and zeros are stored in wo 
the ESW. 



31 
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The remaining bits of the ERW are 
currently reserved and are stored as 
zeros when the ERW is stored. 



Fai ling-Storage Address 



Word 2 of the extended-statu 
an absolute address. When 
subsystem has detected an 
and the fai li ng-storage-addr 
flag (bit 6 of the ERW) 
failing-storage-address fie 
an absolute address that d 
byte location within the ch 
associated with the invalid 
the fai li ng-storage-addr 
flag is zero, this field con 



s word forms 
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CBC. When 
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tains zeros. 



a. The devi ce-connect-time-mea- 
surement mode is inactive. 

b. The channel-subsystem-timing 
facility is not available for 
the subchannel. 

c. The subchannel is not enabled 
for the devi ce-connect-time- 
measurement mode. 

Zeros are stored in bytes and 2-3 of 
word 0, and the LPUM is stored in byte 1 
of word 0. Zeros are stored in words 
1-4. 

The devi ce-connect-time-measurement mode 
is made inactive when SET CHANNEL MONI- 
TOR is executed and bit 31 of general 
register 1 is zero. 

A format-1 ESW has this format: 




Last-Path-Used Mask ( LPUM ): For a defi- 
nition of the LPUM, see the description 
of bits 8-15 of the subchannel logout in 
the section "Subchannel Logout" earlier 
in this chapter. 



EXTENDED-STATUS FORMAT 2 



EXTENDED-STATUS FORMAT 1 



The ESW stored by TEST SUBCHANNEL is a 
format~l ESW when the following condi- 
tions are met: 

1. The extended-status-word-format bit 
(bit 5, word of the SCSW) is 
zero. 

2. The subchannel status-control field 
has the status-pending bit (bit 31, 
word of the SCSW) set to one, 
together with: 



The ESW stored by TEST SUBCHANNEL is a 
format-2 ESW when the following condi- 
tions are met: 

1. The extended-status-word-format bit 
(bit 5, word of the SCSW) is 
zero. 

2. The channel-subsystem-timing facil- 
ity is available for the sub- 
channel . 

3. The subchannel is enabled for the 
devi ce-connect-time-measurement 
mode. 
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4. The devi ce-connect-time-measurement 
mode is active. 

5. The subchannel status-control field 
has the status-pending bit (bit 31, 
word of the SCSW) set to one, 
together with: 

a. The primary-status bit (bit 29, 
word of the SCSW) alone, or 

b. The primary-status bit and 
other status-control bits, or 

c. The intermediate-status bit 
(bit 28, word of the SCSW) 
and the suspended bit (bit 26, 
word of the SCSW). 

Zeros are stored in byte of word 0, 
the LPUM is stored in byte 1 of word 0, 
and the device-connect time is stored in 
bytes 2-3 of word 0. Zeros are stored 
in words 1-4. 

A format-2 ESW has this format*. 





LPUM 


DCTI 









Zeros 



16 



24 



31 



Last-Path-Used Mask (LPUM): For a defi- 
nition of the LPUM, see the description 
of bits 8-15 of the subchannel logout in 
the section "Subchannel Logout" earlier 
in this chapter. 

Devi ce-Connect-Time Interval ( DCTI ) : 
Bits 16-31 contain the binary count of 
time increments accumulated by the chan- 
nel subsystem during the time that the 
channel subsystem and the device were 
actively communicating and the subchan- 
nel was subchannel-active. The time 
increment of the DCTI is 128 microsec- 
onds. 



If the above conditi 
of the DCTI value in 
the devi ce-connect-t 
was made active by 
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Note : The DCTI value stored in the ESW 
is the same as that used to update the 
corresponding measurement-block data for 
the subchannel if the measurement- 
block-update mode is in use for the 
subchannel. If the measurement-block- 
update mode for the channel subsystem is 
active and the subchannel is enabled for 
the devi ce-connect-time-measurement mode 
but no DCTI value is stored in the ESW 
(because of the presence of subchannel- 
logout information), or if the DCTI is 
zeros, then nothing is added to the 
corresponding measurement-block data. 



EXTENDED-STATUS FORMAT 3 



The ESW stored by TEST SUBCHANNEL is a 
format-3 ESW when the extended-status- 
word-format bit (bit 5, word of the 
SCSW) is zero and the subchannel is 
status-pending with (1) secondary 
status, alert status, or both when 
primary status is not also present, or 
(2) intermediate status when the 
subchannel is not suspended. Zeros are 
stored in byte of word 0, and the LPUM 
is stored in byte 1 of word 0. Bytes 
2-3 of word contain unpredictable 
values. Zeros are stored in words 1-4. 

A format-3 ESW has this format: 





LPUM 


xxxxxxxx 


xxxxxxxx 











Zeros 



16 



24 



31 



Last-Path-Used Mask ( LPUM ): For a defi- 
nition of the LPUM, see the description 
of bits 8-15 of the subchannel logout in 
the section "Subchannel Logout" earlier 
in this chapter. 



An "X" in the format indicates 
may be zero or one. 



the bit 



The figure "Information Stored in ESW" 

summarizes the conditions at the 

subchannel under which each type of 

information is stored in the ESW. 



16-42 370-XA Principles of Operation 



Subchannel Conditions When IRB Is Stored 


Extended- 
Status 
Word (ESW), 
Word 


Subchannel-Status 
Word 




Path-Management- 
Control Word 










Devi ce- 


Status- 
Control 
Field 

AIPSX 


L 
Bit 


Sus- 
pen- 
ded 
Bit 


Devi ce- 

Connect- 

Time- 

Msrmnt 

Mode 


Timing- 
Faci li ty 
Bit 


Connect- 

Time- 

Msrmnt- 

Mode- 

Enable 

Bit 






Format 


Contents 

Bytes 
0,1,2,3 





//////////////////////////////////// 


U 


xxxx 


00001 





/////////////////////////////// 


01001 








////////////////////////// 


1 


Inacti ve 


///////////////// 


1 


ZMZZ 


Active 





rfffffff 
//////// 


1 





1 


2 


ZMDD 


xxixi 





//// 
//// 
//// 
//// 
//// 
//// 
//// 


Inacti ve 


///////////////// 


1 


ZMZZ 


Acti ve 





//////// 


1 





1 


2 


ZMDD 


KK011 





/////////////////////////////// 
/////////////////////////////// 
/////////////////////////////// 


3 


ZMXX 


1X001 





XXXX1 


1 


/////////////////////////////// 





RRRR 


Explanati on: 


bo be not meaningful when X is z 


ero. 




Defined • 


X Bits may be zeros or ones. 

/ Information not relevant in this situati 

A Alert status. 

D Accumulated devi ce-connect-time-i nterval 

value stored in bytes 2 and 3. 
I Intermediate status. 
L Extended-status-word format. 
M Last-path-used mask (LPUM) stored in byt 


on . 
(DCTI) 

e 1. 




P Primary status. 

R Subchannel-logout information stored in 

S Secondary status. 

U No format defined. 

X Status-pending. 

Z Bits are stored as zeros. 


word 0. 





Information Stored in ESW 
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EXTENDED-CONTROL WORD 



The extended-control word provides addi- 
tional information to the program 
describing conditions that may exist at 
the channel subsystem, subchannel, or 
device. The extended-control (E) bit 
(bit 14, word of the SCSW), when one, 
indicates that model-dependent informa- 
tion has been stored in the extended- 
control word. 

The extended-control word may be stored 
only when the extended-status-word- 
format bit (bit 5, word of the SCSW) 
is also stored as one. 

The information provided in the 
extended-control word is as follows: 



SCSW 

Word 

Bi ts 1 

5 14 


ECW 
Words 0-7 




1 
1 1 


Unpredi ctable 2 
Unpredi ctable 2 
Model-dependent information 3 


1 The combination 01 is reserved for 
future use. 

2 If stored, the value of these 
words is unpredictable. 

3 Unused bits in the model-dependent 
information are stored as zeros. 
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Channel-Subsystem Monitoring 17-1 

Channel-Subsystem Timing 17-1 

Channel-Subsystem Timer 17-2 

Measurement-Block Update 17-2 

Measurement Block 17-2 

Measurement-Block Origin 17-4 

Measurement-Block Key 17-4 

Measurement-Block Index 17-4 

Measurement-Block-Update Mode 17-5 

Measurement-Block-Update Enable 17-5 

Time-Interval-Measurement Accuracy 17-5 

Devi ce-Connect-Time Measurement 17-5 

Devi ce-Connect-Time-Measurement Mode 17-6 

Devi ce-Connect-Time-Measurement Enable 17-6 

Signals and Resets 17-6 

Signals 17-6 

Halt Signal 17-7 

Clear Signal 17-7 

Reset Signal 17-7 

Resets 17-7 

Channel-Path Reset 17-7 

I/0-System Reset 17-8 

Externally Initiated Functions 17-11 

Initial Program Loading 17-11 

Reconfiguration of the I/O System 17-13 

Status Verification 17-14 

Address- Limit Check i ng 17-14 

Configuration Alert 17-14 

Incorrect- Length- Indication Suppression 17-15 

Channel-Subsystem Recovery 17-15 

Channel Report 17-16 

Channel-Report Word (CRW) 17-17 



The I/O support functions are those 
functions of the channel subsystem that 
are not directly related to the initi- 
ation or control of I/O operations. The 
following I/O support functions are 
described in this chapter: channel- 
subsystem monitoring* signals and 
resets, externally initiated functions, 
status verification, address-limit 
checking, configuration alert, and 
channel-subsystem recovery. 



CHANNEL-SUBSYSTEM MONITORING 



Monitoring facilities ar 
the channel subsystem 
program can retrieve mea 
performance for a designa 
The use of these facil 
program control by means 
MONITOR. Additionally, 
can be selectively enabl 
facilities by means 
SUBCHANNEL. 
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of SET CHANNEL 
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ed to use the 

of MODIFY 



The channel-subsystem-monitoring facili- 
ties include the channel-subsystem- 
timing facility, measurement-block- 



update facility, and devi ce-connect- 
time-measurement facility. The latter 
two facilities are logically distinct 
and operate independent of one another. 
Each of the three facilities that 
constitute the channel-subsystem- 
monitoring facilities is described in 
this section. 



CHANNEL-SUBSYSTEM TIMING 



The channel-subsystem-timing facility 
provides the channel subsystem with the 
capability of measuring the elapsed time 
required for performing several differ- 
ent phases in processing a start func- 
tion initiated by START SUBCHANNEL. 
These elapsed-time measurements are used 
by both the measurement-block-update 
facility and the devi ce-connect-time- 
measurement facility to provide 
subchannel-performance information to 
the program. 

While every channel subsystem has a 
channel-subsystem-timing facility, it 
may or may not be provided for use with 
all subchannels. Subchannels for which 
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the facility is provided have the 
timing-facility bit (bit 14 of word 1) 
stored as one in the associated 
subchannel-information block. (See the 
section "Subchannel-Information Block" 
in Chapter 15, "Basic I/O Functions.") 
If the channel-subsystem-timing facility 
is not provided for the subchannel, its 
timing-facility bit is stored as zero. 

Subchannels that do not have the 
channel-subsystem-timing facility pro- 
vided are those for which the character- 
istics of the associated device, the 
manner in which it is attached to the 
channel subsystem, - or the channel- 
subsystem resources required to support 
the device are such that use of the 
channel-subsystem-timing facility is 
precluded. 

The channel-subsystem-timing facility 
consists of at least one channel- 
subsystem timer and the associated logic 
and storage required for computing and 
recording the elapsed-time intervals for 
use by the two measurement facilities. 
The aspects of the channel-subsystem- 
timing facility that are of importance 
to the program are described below. 



Channel -Subsystem Timer 



Each channel-subsystem timer is a binary 
counter that is not accessible to the 
program. The channel-subsystem timer is 
incremented by adding a one to the 
rightmost bit position every 128 micro- 
seconds. When incrementing the 
channel-subsystem timer causes a carry 
out of the leftmost bit position, the 
carry is ignored, and counting continues 
from zero. No indications are generated 
as a result of the overflow. 



Just as every CPU has acce 
clock, every channel sub 
access to at least one chann 
timer. When multiple chann 
timers are provided, syn 
among these timers is als 
creating the effect that al 
facilities of the channe 
share a single timer. Syn 
among these timers may 
either through some TOD clo 
pendently by the channel sub 
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If the TOD clocks are not synchronized, 
the elapsed times measured by the 
channel-subsystem-timing facility may, 
depending upon the model, have unpre- 
dictable values for some or all of the 
subchannels, depending on the particular 
channel-subsystem timer and the way the 
associated devices are physically 
attached to the system. The values are 
unpredictable for those devices attached 
to the system by separately configurable 
channel paths whose associated CPU TOD 
clocks are not synchronized. 



Svnchroni zati on : If either the measure- 
ment-block-update mode or device- 
connect-time-measurement mode is active 
and any of the channel-subsystem timers 
are found to be out of synchronization, 
a channel-subsystem-timei — sync check is 
recognized, and a channel report is 
generated to alert the program (see the 
section "Channel-Subsystem Recovery" 
later in this chapter). If neither of 
these modes is active, the lack of 
synchronization is not recognized. 



MEASUREMENT-BLOCK UPDATE 



The measurement-block-update facility 
provides the program with the capability 
of accumulating performance information 
for designated subchannels. The program 
designates a contiguous area of absolute 
storage and subdivides this area into 
32-byte blocks, one block for each 
designated subchannel. Information is 
accumulated in the block designated for 
the subchannel by the program each time 
an I/O operation or chain of I/O oper- 
ations initiated by START SUBCHANNEL is 
suspended or completed. The completion 
of an I/O operation or chain of I/O 
operations is normally signaled by the 
primary interruption condition. Accumu- 
lation of performance information by the 
measurement-block-update facility is 
under program control by means of the 
measurement-mode-control bit for 
measurement-block update as specified by 
the execution of SET CHANNEL MONITOR, 
and by the measurement-block-update- 
enable bit as specified by the execution 
of MODIFY SUBCHANNEL. Five fields are 
defined in the measurement block in 
which measurement data is accumulated by 
the measurement-block-update facility: 
SSCH+RSCH count, sample count, device- 
connect time, function-pending time, and 
device-disconnect time. 



Measurement Block 



The measurement block is a 32-byte area 
at the location designated by the 
program, using the measurement-block 
origin in conjunction with the 
measurement-block index. The measure- 
ment block contains the accumulated 
values of the measurement data described 
below. When the measurement-block- 
update mode is active and the subchannel 
is enabled for measurement-block update, 
the measurement-block-update facility 
accumulates the values for the measure- 
ment data that accrue during the 
execution of an I/O operation or chain 
of I/O operations initiated by START 
SUBCHANNEL. 
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count and words 1-3, or when the 
timing-facility bit for the subchannel 
SSCH+RSCH count is not 
the measurement-block- 



If any of the accrued time values is 
detected to exceed the internal storage 
provided for accruing these values, none 
of the accrued values are added to the 
measurement block for the subchannel, 
the sample count is not incremented, but 
the SSCH+RSCH count is incremented. 

Accesses to the measurement block by the 
measurement-block-update facility, in 
order to accumulate measurement data at 
the suspension or completion of an I/O 
function, appear block-concurrent to 
CPUs. CPU accesses to the block, either 
fetches or stores, are inhibited during 
the time the measurement-block update is 
being performed by the measurement- 
block-update facility. 

The measurement block has the following 
format: 



Word 
1 
2 
3 

5 
6 
7 



SSCH+RSCH Count t Bits 0-15 of word 
are used as a binary counter. When 
either the suspend function is performed 
or the primary interruption condition is 
recognized during the performance of a 
start function, the counter is incre- 
mented by adding one in bit position 15, 
and the measurement data is stored. The 
counter wraps around from the maximum 
value of 65,535 to 0. The program is 
not alerted when counter overflow 
occurs. 

If the measurement-block-update mode i s 
active and the subchannel is enabled for 
measuring, the SSCH+RSCH count is incre- 
mented even when the lack of measured 
values for an individual start function 
precludes the updating of the sample 



SSCH+RSCH Count 


Sample Count 


Device-Connect Time 


Function-Pending Time 


Device-Disconnect Time 


Reserved 



is zero. The 
incremented if 
update mode 
subchannel i s 
measurement-block 
subchannel -logout 



is inactive, if 
not enabled for 
update, or 
information has 



the 

the 

if 

been 



generated for the start function 



Sample Count ? Bits 16-31 of word are 
used as a binary counter. When words 1, 
2, and 3 of the measurement block are 
updated, the counter is incremented by 
adding one in bit position 31. On some 
models, certain conditions may preclude 
the measurement-block-update facility 
obtaining the accrued values of the 
measurement data for an individual start 
function, even when the measurement- 
block-update mode is active and the 
subchannel is enabled for that mode. In 
this situation, the sample-count field 
is not incremented. 

The counter wraps around from the maxi- 
mum value of 65,535 to . The program 
is not alerted when counter overflow 
occurs. This field is not updated if 
the channel-subsystem-timing facility is 
not provided for the subchannel. 

The System Library publication for the 
system model specifies the conditions, 
if any, that preclude the updating of 
the sample count and words 1, 2, and 3 
of the measurement block. 



Devi ce-Connect 



1 contain the 
devi ce-connect-time 
devi ce-connect-t i me 
the sum of the time 
whenever the devi 
connected to a channe 
of transferring info 
and the channel subsy 



Time : Bits 0-31 of word 
accumulation of measured 
intervals. The 
interval (DCTI) is 
intervals measured 
ce is logically 
1 path for purposes 
rmation between it 
stem. 



The time intervals are measured using a 
resolution of 128 microseconds. The 
accumulated value is modulo approximate- 
ly 152.71 hours, and the program is not 
alerted when an overflow occurs. This 
field is not updated if (1) the 
channel-subsystem-timing facility is not 
provided for the subchannel, (2) the 
measurement-block-update mode is inac- 
tive, or (3) any of the three time 
values accrued for the current start 
function has been detected to exceed the 
internal storage in which it was 
accrued. 

Accumulation of devi ce-connect-time 
intervals for a subchannel and storing 
this data in the ESW are not affected by 
whether the measurement-block-update 
mode is active. (See the section 
"Devi ce-Connect-Time Measurement" later 
in this chapter.) 

Functi on-Pending Time : Bits 0-31 of 
word 2 contain the accumulated SSCH- and 
RSCH-functi on-pendi ng time. Function- 
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pending time is the time interval 
between acceptance of the start function 
(or resume function if the subchannel is 
in the suspended state) at the subchan- 
nel and acceptance of the first command 
associated with the initiation or 
resumption of channel-program execution 
at the device. 



the measurement-block area on a 32-byte 
boundary in main storage. The 
measurement-block origin is passed from 
general regi ster 2 to the measurement- 
block-update facility when SET CHANNEL 
MONITOR is executed with bit 30 of 
general register 1 set to one. 



accumulated up to 
the value in the 
field of the 
Functi on-pendi ng 



When channel-program execution is 
suspended because of a suspend flag in 
the first CCW of a channel program, the 
suspension occurs prior to transferring 
the first command to the device. In 
this case, the function-pending time 

that point is added to 

functi on-pendi ng-time 

measurement block. 

time is not accrued 
while the subchannel is suspended. 
Function-pending time begins to be 
accrued again, in this case, when RESUME 
SUBCHANNEL i s subsequently executed 
while the designated subchannel is in 
the suspended state. 

The function-pending-time interval is 
measured using a resolution of 128 
microseconds. The accumulated value is 
modulo approximately 152.71 hours, and 
the program is not alerted when an ovei — 
flow occurs. This field is not updated 
if the channel-subsystem-timing facility 
is not provided for the subchannel. 

Devi ce-Di sconnect Time ? Bits 0-31 of 
word 3 contain the accumulated device- 
disconnect time. Device-disconnect time 
is the sum of the time intervals meas- 
ured whenever the device is logically 
di sconnected from the channel subsystem 
while the subchannel is subchannel- 
acti ve. 

Device-disconnect time is not accrued 
while the subchannel is in the suspended 
state. Device-disconnect time begins to 
be accrued again, in this case, on the 
first device disconnection after 
channel-program execution has been 
resumed at the device (the subchannel is 
again subchannel-active). 

The devi ce-di sconnect-time interval is 
measured by using a resolution of 128 
microseconds. The accumulated value is 
modulo approximately 152.71 hours; the 
program is not alerted when an overflow 
occurs. This field is not updated if 
the channel-subsystem-timing facility is 
not provided for the subchannel. 

Words 4-7 of the measurement block are 
not updated, but are reserved for future 
use. 



Measurement-Block Origin 



The measurement-block origin designates 
the absolute address of the beginning of 



Measurement-Block Key 



Bits 0-3 of general register 1 form the 
four-bit access key to be used for 
subsequent measurement-block updates 
when SET CHANNEL MONITOR causes the 
measurement-block-update mode to be made 
active. The measurement-block key is 
passed to the measurement-block-update 
facility whenever the measurement-block 
origin is passed. 



Measurement-Block Index 



The measurement-block index is set at 
the subchannel by means of the execution 
of MODIFY SUBCHANNEL. The measurement- 
block index designates which 32-byte 
measurement block, relative to the 
measurement-block origin, is to be used 
for accumulating the measurement data 
for the designated subchannel. The 
location of the measurement block of the 
designated subchannel is computed by the 
measurement-block-update facility by 
appending five rightmost zeros to the 
measurement-block index of the subchan- 
nel and adding the result to the 
measurement-block origin. The result is 
the absolute address of the 32-byte 
measurement block for that subchannel. 
When the computed measurement-block 
address exceeds 2 31 - 1, a measurement- 
block program-check condition is 
recognized, and measurement-block updat- 
ing does not occur for the preceding 
subchannel-active period. 



Programmi ng Note 



The initial value of the measurement- 
block index is zero. The program is 
responsible for setting the 
measurement-block index to the proper 
value prior to enabling the subchannel 
for the measurement-block-update mode 
and making the mode active. To preclude 
the possibility of unpredictable results 
for the accumulated data in the measure- 
ment block, each subchannel for which 
measurement data is to be accumulated 
must have a different value for its 
measurement-block index. 
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Measurement-B lock-Update Mode 



The measurement-block-update mode is 
made active by executing SET CHANNEL 
MONITOR when bit 30 of general register 
lis one. If bit 30 of general register 

1 is zero when SET CHANNEL MONITOR is 
executed, the mode is made inactive. 
Ulhen the measurement-block-update mode 
is inactive, no measurement values are 
accumulated in main storage. When the 
measurement-block-update mode is made 
active, the contents of general register 

2 are passed to the measurement-block- 
update facility as the absolute address 
of the measurement-block origin. Bits 
0-3 of general register 1 are also 
passed to the measurement-block-update 
facility as the access key to be used 
when updating the measurement block for 
each subchannel. Ulhen the measurement- 
block-update mode is active, 
measurements are accumulated in individ- 
ual blocks within the measurement-block 
area for subchannels whose measurement- 
block-update-enable bit is one. (See 
the section "Measurement Block" earlier 
in this chapter for a description of the 
measurement data that is accumulated.) 

If the measurement-block-update mode is 
already active when SET CHANNEL MONITOR 
is executed, the values for the 
measurement-block origin and measure- 
ment-block key that are used for a 
subchannel enabled for measuring depend 
on whether SET CHANNEL MONITOR is 
executed prior to, during, or subsequent 
to execution of START SUBCHANNEL for 
that subchannel. If SET CHANNEL MONITOR 
is executed prior to START SUBCHANNEL, 
the current measurement-block origin and 
measurement-block key are in control. 
If SET CHANNEL MONITOR is executed 
during or subsequent to execution of 
START SUBCHANNEL, it is unpredictable 
whether the measurement-block origin and 
measurement-block key that are in 
control are old or current. 



Measurement-Block-Update Enable 



Bit 11, word 1, of the SCHIB is the 
measurement-block-update enable bit. 
This bit provides the capability of 
controlling the accumulation of measure- 
ment data for designated subchannels. 
The initial value of the enable bit is 
zero. When MODIFY SUBCHANNEL is 
executed with this enable bit set to one 
in the SCHIB operand, the subchannel is 
enabled for the measurement-block-update 
mode. If the measurement-block-update 
mode is active, the measurement-block- 
update facility begins accumulating 
measurement data for the designated 
subchannel when START SUBCHANNEL is next 
executed. Conversely, if MODIFY 
SUBCHANNEL is executed with this enable 
bit set to zero, the subchannel is disa- 



bled for the measurement-block-update 
mode, and no additional measurement data 
is accumulated for that subchannel. 



Time- Interval -Measurement Accuracy 
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ntervals are 
n code i s 
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latency may 
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Programmi ng Notes 



Excessive delays may be encountered 
by the channel subsystem when 
attempting to update measurement 
data if the program is concurrently 
accessing the same measurement- 
block area. A programming 
convention should ensure that the 
storage block designated by SET 
CHANNEL MONITOR is made read-only 
whi le the measurement-block-update 
mode i s acti ve. 



To ensure that p 
support measurem 
executed proper 
should initialize 
ment blocks to 
making the measur 
mode active. 
appear in the un 
4-7) of the measu 



rograms w 
ent funct 
ly, the 
all the 
zeros 
ement-blo 
nly zero 
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prior to 
ck-update 
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ocks. 



When the incrementing of an accumu- 
lated value causes a carry to be 
propagated out of bit position 0, 
the carry is ignored, and accumu- 
lating continues from zero on. 



DEVICE-CONNECT-TIME MEASUREMENT 



The devi ce-connect-time-measurement fa- 
cility provides the program with the 
capability of retrieving the length of 
time that a device is actively communi- 
cating with the channel subsystem while 
executing a channel program. The meas- 
ured length of time that the device is 
actively communicating on a channel path 
during the execution of a channel 
program is called the devi ce-connect- 
time interval (DCTI). If the channel- 
subsystem-timing facility is available 
for the subchannel, the DCTI value is 
passed to the program in the extended- 
status word (ESW) at the completion of 
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the operation when TEST SUBCHANNEL 
(1) clears the primary interruption 
condition or (2) clears the intermediate 
interruption condition alone while the 
subchannel is suspended. The DCTI value 
passed in the ESW pertains to the previ- 
ous subchannel-active period. The 
storing of the DCTI value in the ESW is 
under program control by means of the 
measurement-mode-control bit for 
device-connect time as specified by the 
execution of SET CHANNEL MONITOR, and by 
the devi ce-connect-time-measurement- 
enable bit as specified by the execution 
of MODIFY SUBCHANNEL. However, the DCTI 
value is not stored in the ESW if the 
start function initiated by START 
SUBCHANNEL is terminated because of an 
error condition that is described by 
subchannel logout (see the section 
"Extended-Status Format 0" in Chapter 
16, "I/O Interruptions"). In this case, 
the extended-status-word-format bit of 
the SCSW is stored as one, indicating 
that the ESW contains subchannel-logout 
information describing the error condi- 
tion. See the section "Extended-Status 
Word" in Chapter 16, "I/O 
Interruptions," for the description of 
the subchannel-logout information. If 
the accrued DCTI value exceeded 8.388608 
seconds during the previous subchannel- 
active period, then the maximum value 
(FFFF hex) is passed in the ESW. 



Devi ce-Connect-Time-Measurement Mode 



Provision of the DCTI value in the 
measurement-block area is not affected 
by whether the devi ce-connect-time- 
measurement mode is active. 



Devi ce-Connect-Time-Measurement Enable 



Bit 12, word 1, of the SCHIB is the 
devi ce- connect- time-measurement enable 
bit. This bit provides the program with 
the capability of controlling the stoi — 
ing of DCTI values for a subchannel when 
the devi ce-connect-time-measurement mode 
is active. The initial value of the 
enable bit is zero. When MODIFY 
SUBCHANNEL is executed with this enable 
bit set to one in the SCHIB operand, the 
subchannel is enabled for the devi ce- 
connect-time-measurement mode. If the 
devi ce-connect-time-measurement mode is 
active, the devi ce-connect-time- 
measurement facility begins accumulating 
DCTI values for the designated subchan- 
nel when START SUBCHANNEL is next 
executed. In this situation, the DCTI 
values are provided in the ESW (see the 
section "Extended-Status Format 2" in 
Chapter 16, "I/O Interruptions"). 
Conversely, if MODIFY SUBCHANNEL is 
executed with this enable bit set to 
zero, the subchannel is disabled for the 
devi ce-connect-time-measurement mode, 
and no additional DCTI values are passed 
to the program for that subchannel. 



The devi ce-connect-time-measurement mode 
is made active by executing SET CHANNEL 
MONITOR when bit 31 of general register 
1 is one. If bit 31 of general register 
1 is zero when SET CHANNEL MONITOR is 
executed, the mode is made inactive, and 
DCTIs are not passed to the program. If 
the channel-subsystem-timing facility is 
available for the subchannel, the 
devi ce-connect-time-measurement mode is 
active, and the subchannel is enabled 
for the mode, the DCTI value is passed 
to the program in the ESW stored when 
TEST SUBCHANNEL (1) clears the primary 
interruption condition with no 
subchannel-logout information indicated 
in the SCSW (extended-status-word-format 
bit is zero) or (2) clears the interme- 
diate interruption condition alone while 
the subchannel i s suspended. 



SIGNALS AND RESETS 



During system operation, it may become 
necessary to terminate an I/O operation 
or to reset either the I/O system or a 
portion of the I/O system. (The I/O 
system consists of the channel subsystem 
plus all of the attached control units 
and devices.) Various signals and 
resets are provided for this purpose. 
Three signals are provided for the chan- 
nel subsystem to notify an I/O device to 
terminate an operation or perform a 
reset function or both. Two resets are 
provided to cause the channel subsystem 
to reinitialize certain information 
contained either at the I/O device or at 
the channel subsystem. 



If a start function is currently being 
performed with a subchannel enabled for 
the devi ce-connect-time-measurement mode 
when SET CHANNEL MONITOR makes this mode 
active for the channel subsystem, the 
value of the DCTI stored under the 
appropriate conditions may be zero, a 
partial result, or the full and correct 
value, depending on the model and the 
progress of the start function at the 
time the mode was activated. 



SIGNALS 



The request that the channel subsystem 
initiate a signaling sequence is made by 
one of the following: 

1. The program executing the CLEAR 
SUBCHANNEL, HALT SUBCHANNEL, or 
RESET CHANNEL PATH instruction 
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2. The I/O device signaling I/0-error 
alert 

3. The channel subsystem itself upon 
detecting certain error conditions 
or equipment malfunctions 

The three signals are the halt signal, 
the clear signal, and the reset signal. 



available. Status information in the 
device and control unit is reset, but an 
interruption condition may be generated 
upon the completion of any mechanical 
operati on. 



Reset Si qnal 



Halt Si gnal 



The halt signal is provided so the chan- 
nel subsystem can terminate an I/O opei — 
at ion. The halt signal is issued by the 
channel subsystem as part of the halt 
function performed subsequent to the 
execution of HALT SUBCHANNEL. The halt 
signal is also issued by the channel 
subsystem when certain error conditions 
are encountered. The halt signal 
results in the channel subsystem using 
the interface-disconnect sequence 
control defined in the System Library 
publication IBM System/560 and 
System/370 I/O Interface Channel to 
Control Unit OEMI , GA22-6974. 



The reset signal i 
channel subsystem 
devices on a channe 
signal is issued by 
tern as part of the 
function performed 
execution of RESET 
reset signal is also 
nel subsystem as 
system-reset functio 
results in the chan 
the system-reset 
defined in the Syst 
tion IBM Svstem/360 
Interface Channel to 
GA22-6974. 



RESETS 



s provided so the 

can reset all I/O 

1 path. The reset 

the channel subsys- 

channel -path- reset 

subsequent to the 

CHANNEL PATH. The 

i ssued by the chan- 

part of the 1/0- 

n. The reset signal 
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sequence control 

em Library publica- 

and Svstem/370 I/O 

Control Unit OEMI, 



Clear Si gnal 



The clear signal is provided so the 
channel subsystem can terminate an I/O 
operation and reset status and control 
information contained at the device. 
The clear signal is issued as part of 
the clear function performed subsequent 
to the execution of CLEAR SUBCHANNEL. 
The clear signal is also issued by the 
channel subsystem when certain error 
conditions or equipment malfunctions are 
detected by the I/O device or the chan- 
nel subsystem. The clear signal results 
in the channel subsystem using the 
selective-reset sequence control defined 
in the System Library publication IBM 
System/360 and System/370 I/O Interface 
Channel to Control Unit OEMI , GA22-6974. 

If an I/O operation is in progress at 
the device and the device is actively 
communicating over a channel path in the 
execution of that I/O operation when a 
clear signal is received on that channel 
path, the device immediately disconnects 
from that channel path. Data transfer 
and any operation using the facilities 
of the control unit are immediately 
concluded, and the I/O device is not 
necessarily positioned at the beginning 
of a block. Mechanical motion not 
involving the use of the control unit, 
such as rewinding magnetic tape or posi- 
tioning a disk-access mechanism, 
proceeds to the normal stopping point, 
if possible. The device may appear busy 
until termination of the mechanical 
motion or the inherent cycle of opera- 
tion, if any, whereupon it becomes 



Two resets are provided so the channel 
subsystem can reinitialize certain 
information contained at either the I/O 
device or the channel subsystem. The 
request that the channel subsystem 
initiate one of the reset functions is 
made by one of the following: 

1. The program executing the RESET 
CHANNEL PATH instruction 

2. The operator activating a system- 
reset-clear or system-reset-normal 
key or a load-clear or load-normal 
key 

3. The channel subsystem itself upon 
detecting certain error conditions 
or equipment malfunctions 



The resets are channel-path reset 
I/Q-system reset. 



and 



Channel-Path Reset 



The channel-path-reset facility 
a mechanism to reset certain in 
that pertain to a designated 
path at all associated sub 
Channel-path reset occurs when 
nel subsystem performs the 
path-reset function initiated 
CHANNEL PATH. (See the secti 
CHANNEL PATH" in Chapter 
Instructions.") All interna 
cations of dedicated al 
control-unit busy, and device 
pertain to the designated cha 
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are cleared in all subchannels, and 
reset is signaled on that channel path. 
The receipt of the reset signal by 
control units attached to that channel 
path causes all operations in progress 
and all status, mode settings, and alle- 
giance pertaining to that channel path 
of the control unit and its attached 
devices to be reset. (See also the 
description of the system-reset-signal 
actions in the section "I/0-System 
Reset" in this chapter.) 

The results of the channel-path-reset 
function on the designated channel path 
are communicated to the program by means 
of a subsequent machine-check-interrup- 
tion condition generated by the channel 
subsystem (see the section "Channel- 
Subsystem Recovery" in this chapter). 



I/0-Svstem Reset 



The I/O-system-reset function is per- 
formed when the channel subsystem is 
powered on, when initial program loading 
is initiated manually (see the section 
"Initial Program Loading" later in this 
chapter), and when the system-reset- 
clear or system-reset-normal key is 
activated. The I/O-system-reset func- 
tion cannot be initiated under program 
control; it must be initiated manually. 
I/O-system reset may fail to complete 
due to malfunctions detected at the 
channel subsystem or at a channel path. 
I/O-system reset is performed as part of 
subsystem reset, which also resets all 
floating interruption requests, includ- 
ing pending I/O interruptions. (See the 
section "Subsystem Reset" in Chapter 4, 
"Control.") Detailed descriptions of 
the effects of I/O-system reset on the 
various components of the I/O system 
appear later in this chapter. 

I/O-system reset provides a means for 
placing the channel subsystem and its 
attached I/O devices in the initialized 
state. I/O-system reset affects only 
the channel-subsystem configuration in 
which it is performed, including all 
channel-subsystem components configured 
to that channel subsystem. I/O-system 
reset has no effect on any system compo- 
nents that are not part of the channel- 
subsystem configuration that is being 
reset. The effects of I/O-system reset 
on the configured components of the 
channel subsystem are described in the 
following sections. 



Channel -Subsystem State ? 
reset causes the channel s 
placed in the initialize 
all the channel-subsystem 
the states described in 
sections. All operations 
are terminated and reset, 
cations of prior conditio 
These indications include 
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mation, interruption conditions (but not 
pending interruptions), dedicated- 
allegiance conditions, pending channel 
reports, and all internal information 
regarding prior conditions and oper- 
ations. In the initialized state, the 
channel subsystem has no activity in 
progress and i s ready to perform the 
initial-program-loading (IPL) function 
or respond to I/O instructions, as 
described in Chapter 14, "I/O 
Instructions." 

Control Units and Devi ces t I/O-system 
reset causes a reset signal to be sent 
on all configured channel paths, includ- 
ing those which are not physically 
available (as indicated by the PAM bit 
being zero) because of a permanent error 
condition detected earlier. When the 
reset signal is received by a control 
unit, control-unit functions in 
progress, control-unit status, control- 
unit allegiance, and control-unit modes 
for the resetting channel path are 
reset. Device operations in progress, 
device status, device allegiance, and 
the device mode for the resetting chan- 
nel path are also reset. Control-unit 
and device mode, allegiance, status, and 
I/O functions in progress for other 
channel paths are not affected. 

For devices that are operating in 
single-path mode, an operation can be in 
progress for, at most, one channel path. 
Therefore, if the reset signal is 
received on that channel path, the oper- 
ation in progress is reset. Devices 
that have the dynami c-reconnecti on 
feature and are operating in mult i path 
mode, however, have the capability to 
establish an allegiance to a group of 
channel paths during an I/O operation, 
where all the channel paths of the path 
group are configured to the same channel 
subsystem. If an operation is in 
progress for a device that is operating 
in mult i path mode and the reset signal 
is received on one of the channel paths 
of that path group, then the operation 
in progress is reset for the resetti ng 
channel path only . Although the opera- 
tion in progress cannot continue on the 
resetting channel path, it can continue 
on the other channel paths of the path 
group, subject to the following 
restrictions: 

1. If the device is actively communi- 
cating with the channel subsystem 
on a channel path when it receives 
the reset signal on that channel 
path, then the operation is reset 
unconditionally, regardless of path 
groups. 

2. If the operation is in progress in 
mult i path mode but the path group 
consists only of the resetting 
path, then the operation is reset. 

3. Except as noted in item 2 above, if 
the operation in progress is 
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currently in a disconnected state 
(device not actively communicating 
with the channel subsystem) or is 
active on another channel path of a 
path group, system reset has no 
effect upon continued execution of 
the operation. 

A control unit is completely reset after 
the reset signal has been received on 
all its channel paths, provided no new 
activity is initiated at the control 
unit between the receipt of the first 
and last reset signal. "Completely 
reset" means that the current operation, 
if any, at the control unit is termi- 
nated and that control-unit allegiance, 
control-unit status, and the control- 
unit mode, if any, are reset. 

An I/O device is completely reset after 
the reset signal has been received on 
all channel paths of all control units 
by which the device is accessible, 
provided no new activity is initiated at 
the device between the receipt of the 
first and last reset signal. "Complete- 
ly reset" means that the current 
operation, if any, at the device is 
terminated and that device allegiance, 
device status, and the device mode are 
reset. 
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The reset signal is not received by 
control units and devices on channel 
paths from which the control unit has 
been partitioned. A control unit is 
partitioned from a channel path by means 
of an enable/disable switch on the 
control unit for each channel path by 
which it is accessible. Multi tagged, 
unsolicited status, if any, remains 
pending at the control unit for such a 
channel path in this case. However, 
from the point of view of the program, 
the control unit and device appear to be 
completely reset if the reset signal is 
received by the control unit on all the 
channel paths by which it is currently 
accessible. 

The resultant reset state of individual 
control units and devices is described 
in the System Library publication for 
the control unit. 

Channel Paths : I/0-system reset causes 
a reset signal to be sent on all config- 
ured channel paths and causes the chan- 
nel subsystem to be placed in the reset 
and initialized state, as described in 



the previous sections. As a result of 
these actions, all communication between 
the channel subsystem and its attached 
control units and devices is terminated 
and the components reset, and all 
configured channel paths are made quies- 
cent or are deconf i gured. The channel 
subsystem uses the system-reset sequence 
control defined in the System Library 
publication IBM System/360 and 
System/370 I/O Interface Channel to 
Control Unit OEMI, GA22-6974, to bring 
the channel paths into the quiescent 
state. 

Subchannels : I/0-system reset causes 
all operations on all subchannels to be 
concluded. Status information, all 
interruption conditions (but not pending 
interruptions), dedi cated-allegi a nee 
conditions, and internal indications 
regarding prior conditions and opei — 
ations at all subchannels are reset, and 
all valid subchannels are placed in the 
initialized state. 

In the initialized state, the subchannel 
parameters of all valid subchannels have 
their initial values. The initial 
values of the following subchannel 
parameters are zeros: 

Interruption parameter 

I/O-i nterrupti on subclass code 

Enabled 

Limit mode 

Multi path mode 

Measurement mode 

Path-not-operational mask 

Last-path-used mask 

Measurement-block index 

The initial values of the following 
subchannel parameters are assigned as 
part of the installation procedure for 
the device associated with each valid 
subchannel ' 

Timing facility 

Device number 

Logical-path mask (same value as 

path-installed mask) 
Path-installed mask 
Path-available mask 
Channel-path ID 0-7 

The values assigned may depend upon the 
particular system model and the config- 
uration; dependencies, if any, are 
described in the System Library publica- 
tion for the system model. Programming 
considerations may further constrain the 
values assigned. 

The initial value of the path- 
operational mask is all ones. 

The device-number-valid bit is one for 
all subchannels having an assigned I/O 
devi ce. 

The initial value of the model-dependent 
area of the subchannel-information block 
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is described in the System Library 
publication for the system model. 

The initial value of the subchannel- 
status word and extended-status word is 
all zeros. 



The initialized state 
is the state specif i 
values for the sub 
described above. The 
subchannel parameter 
the section "Sub 
Block" in Chapter 15 
tions"; the section 
Word" in Chapt 
Interruptions"; and 
"Extended-Status Wor 
"I/O Interruptions." 



of the subchannel 
ed by the initial 
channel parameters 

description of the 
s can be found in 
channel - 1 nformati on 
, "Basic I/O Func- 

"Subchannel-Status 

er 16, "I/O 

in the section 

d" in Chapter 16, 



Channel -Path-Reset Faci li tv ? I/0-system 
reset causes the channel-path-reset 
facility to be reset. A channel-path- 
reset function initiated by RESET CHAN- 
NEL PATH, either pending or in progress, 
is overridden by I/O-system reset. The 
machi ne-check-i nterrupti on condi ti on, 
which normally signals the completion of 
a channel-path-reset function, is not 
generated for a channel-path-reset func- 
tion that is pending or in progress at 
the time I/O-system reset occurs. 

Address-Li mi t-Checki ng Faci li ty : I/O- 
system reset causes the address-limit- 



checking facility to be reset. The 
address-limit value is initialized to 
all zeros and validated. 

Channel-Subsvstem-Moni tori ng Faci li ti es ? 
I/O-system reset causes the channel- 
subsystem-monitoring facilities to be 
reset. The measurement-block-update mode 
and the devi ce-connect-time-measurement 
mode, if active, are made inactive. The 
measurement-block origin and the mea- 
surement-block key are both initialized 
to zeros and validated. 

Pending Channel Reports : I/O-system 
reset causes pending channel reports to 
be reset. 

Channel -Subsystem Timer ? I/O-system 
reset does not necessarily affect the 
contents of the channel-subsystem timer. 
In models that provide channel- 
subsystem-timer checking, I/O-system 
reset may cause the channel-subsystem 
timer to be validated. 

Pendj ng I/O Interruptions : I/O-system 
reset does not affect pending I/O inter- 
ruptions. However, during subsystem 
reset, I/O interruptions are cleared 
concurrently with the performance of 
I/O-system reset. See the section "Sub- 
system Reset" in Chapter 4, "Control." 
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Area Affected 



Effect of I/0-System Reset 1 



Channel-subsystem state 
Control units and devices 
Channel paths 
Subchannels 

Interruption parameter 

I/O-i nterrupti on subclass code 

Enabled bit 

Limit-mode bits 

Timing-facility bit 

Multi path-mode bit 

Measurement-mode bits 

Device-numbei — valid bit 

Device number 

Logical-path mask 

Path-not-operational mask 

Last-path-used mask 

Path-installed mask 

Measurement-block index 

Path-operational mask 

Path-available mask 

Channel-path ID 0-7 

Subchannel-status word 

Extended-status word 

Model-dependent area 
Channel-path-reset facility 
Address-limit-checking facility 

Address-limit value 
Channel-subsystem-moni tori ng 
faci li ty 

Measurement-block-update mode 

Devi ce-connect-t i me- 
measurement mode 

Measurement-block origin 

Measurement-block key 
Pending channel-report words 
Channel-subsystem timer 



or deconf i gured 2 
initiali zed 



Reset and initialized 

Reset 

Qui escent 

Reset and 

Zeros 3 

Zeros 3 

Zero 3 

Zeros 3 

Installed value 3 

Zero 3 

Zeros 3 

Installed value 3 

Installed value 3 

Equal to path-installed 

mask value 3 
Zeros 3 
Zeros 3 

Installed value 3 
Zeros 3 
Ones 3 

Installed value 3 4 
Installed value 3 
Zeros 3 
Zeros 3 

Model -dependent 3 
Reset 

Reset and initialized 
Zeros 3 
Reset and initialized 

Inacti ve 3 
Inacti ve 3 

Zeros 3 

Zeros 3 

Cleared 

Unchanged/val i dated 



Explanati on : 



For a detailed description of the effect of I/0-system 
reset on each area, see the text. 

Channel-path malfunctions may cause a channel path to 
be deconf i gured. 

Initialized value. 

Also subject to model-dependent configuration controls, 
if any. 



Summary of I/O-System-Reset Actions 



EXTERNALLY INITIATED FUNCTIONS 



I/0-system reset, which is an externally 
initiated function, is described in the 
section "I/O-System Reset" earlier in 
this chapter. 



INITIAL PROGRAM LOADING 



Initial program loading (IPL) provides a 
manual means for causing a program to be 



read from a designated device and for 
initiating execution of that program. 

Some models may provide additional 
controls and indications relating to 
IPL; this additional information is 
specified in the System Library publica- 
tion for the model. 

IPL is initiated manually by setting the 
load-unit-address controls to a foui — 
digit number to designate an input 
device and by subsequently activating 
the load-clear or load-normal key. 
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Activating the load-clear key causes a 
clear reset to be performed on the 
conf i gurati on. 

Activating the load-normal key causes an 
initial CPU reset to be performed on 
this CPU, CPU reset to be propagated to 
all other CPUs in the configuration, and 
a subsystem reset to be performed on the 
remainder of the configuration. 

In the loading part of the operation, 
after the resets have been performed, 
this CPU enters the load state. This 
CPU does not necessarily enter the 
stopped state during performance of the 
reset. The load indicator is on while 
the CPU is in the load state. 



Subsequently, if cond 
read operation is ini 
designated input devic 
subchannel. The rea 
executed as if a 
instruction Mere execu 
nated CI) the subchann 
to the device number 
load-unit-address cont 
ORB containing all zer 
byte of all ones in 
mask field. The ORB 
interpreted by the cha 
follows: 



itions allow, a 
tiated from the 
e and associated 
d operation is 
START SUBCHANNEL 
ted that desig- 
el corresponding 
specified by the 
rols and (2) an 
os, except for a 
the logical-path 
parameters are 
nnel subsystem as 



Interruption parameter: all zeros 

Subchannel key: all zeros 

Suspend control: zero (suspension 
not allowed) 



CCW format: zero 

CCW prefetch: 
not allowed) 



zero (prefetching 



Ini tial-status-i nterrupti on 
control: zero (no request) 

Address-limit-checking control: 
zero (no checking) 

Suppress suspended interruption: 
zero (suppression not allowed) 

Logical-path mask: ones (all chan- 
nel paths logically available) 

I nco rrect- length- suppress i on mode: 
zero (ignored because format-0 CCWs 
are specified) 



Channel-program address: 
address 



absolute 



The first CCW to be executed may be 
either an actual CCW stored at absolute 
location 0, or the first CCW to be 
executed may be implied. In either 
case, the effect i s as if a format-0 CCW 
were executed that had this format: 



Loc 
00 
04 



00000010 


00000000 0000000000000000 


01100000 


//////// 


0000000000011000 



8 



16 



31 



In the illustration above, the CCW spec- 
ifies a read command with the modifier 
bits zeros, a data address of 0, a byte 
count of 24, the chain-command flag one, 
the suppress- i nco rrect- length- i ndi cat i on 
flag one, the chain-data flag zero, the 
skip flag zero, the program-controlled- 
interruption (PCI) flag zero, the 
indirect-data-address (IDA) flag zero, 
and the suspend flag zero. The CCW 
fetched, as a result of command 
chaining, from location 8 or 16, as well 
as any subsequent CCW in the IPL 
sequence, is interpreted the same as a 
CCW in any I/O operation, except that 
any PCI flags that are specified in the 
IPL channel program are ignored. 

At the time the subchannel is made 
start-pending for the IPL read, it is 
also enabled, which ensures proper 
handling of subsequent status from the 
device by the channel subsystem and 
facilitates subsequent I/O operations 
using the IPL device. (Except for the 
subchannel used by the IPL I/O 
operation, each subchannel must first be 
made enabled by MODIFY SUBCHANNEL before 
it can accept a start function or any 
status from the device.) 

When the IPL subchannel becomes status- 
pending for the last operation of the 
IPL channel program, no I/O- i nterrupti on 
condition is generated. Instead, the 
subsystem ID is stored in absolute 
locations 184-187, zeros are stored in 
absolute locations 188-191, and the 
subchannel is cleared of the pending 
status as if TEST SUBCHANNEL had been 
executed, but without storing informa- 
tion usually stored in an IRB. If the 
subchannel-status field is all zeros and 
the device-status field contains only 
the channel-end indication, with or 
without the device-end indication, the 
IPL I/O operation is considered to be 
completed successfully. If the device- 
end status for the IPL I/O operation is 
provided separately after channel-end 
status, it causes an I/O-i nterrupti on 
condition to be generated. When the IPL 
I/O operation is completed successfully, 
a new PSW is loaded from absolute 
locations 0-7. If the PSW loading is 
successful and if no malfunctions are 
recognized which preclude the completion 
of IPL, then the CPU leaves the load 
state, and the load indicator is turned 
off. If the rate control is set to the 
process position, the CPU enters the 
operating state, and CPU operation 
proceeds under control of the new PSW. 
If the rate control is set to the 
instruction-step position, the CPU 
enters the stopped state, with the manu- 
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al indicator 
been loaded. 



on, after the new PSW has 



Programmi ng Notes 



If the IPL I/O operation or the PSW 
loading is not completed successfully, 
the CPU remains in the load state, and 
the load indicator remains on. 

IPL does not complete when any of the 
following occurs: 

• No subchannel contains a valid 
device number equal to the IPL 
device number specified by the 
load-unit-address controls. 

• A malfunction is detected in the 
CPU, main storage, or channel 
subsystem which precludes the 
completion of IPL. 

• Unsolicited alert status is 
presented by the device subsequent 
to the subchannel becoming start- 
pending for the IPL read and before 
the IPL subchannel becomes 
subchannel-active. The IPL read 
operation is not initiated in this 
case. 

• The IPL device appeared not opera- 
tional on all available channel 
paths to the device, or there were 
no available channel paths. 

• The IPL device presented a status 
byte containing indications other 
than channel end, device end, 
status modifier, control-unit end, 
control unit busy, device busy, or 
retry status during the IPL I/O 
operation. Whenever control-unit 
end, control unit busy, or device 
busy is presented in the status 
byte, normal path-management 
actions are taken. 

• A subchannel-status indication 
other than PCI was generated during 
the IPL I/O operation. 

• The PSW loaded from absolute 
locations 0-7 has a PSW-format 
error of the type that i s recog- 
nized early. 

Except in the cases of no corresponding 
subchannel for the device number entered 
or a machine malfunction, the subsystem 
ID of the IPL device is stored in abso- 
lute locations 184-187; otherwise, the 
contents of these locations are unpre- 
dictable. In all cases of unsuccessful 
IPL, the contents of absolute locations 
0-7 are unpredictable. 

Subsequent to a successful IPL, the 
subchannel parameters contain the normal 
values as if an actual START SUBCHANNEL 
had been executed, designating the ORB 
as described above. 



The information 
absolute locatio 
may be used as 
additional info 
IPL I/O operat 
location 8 may 
additional CCWs 
age, and the 
location 16 
transfei — i n-chan 
i ng transfer to 



read and placed at 

ns 8-15 and 16-23 

CCWs for reading 

rmation during the 

ion: the CCW at 

specify reading 

elsewhere in stor- 

CCW at absolute 

may specify the 

nel command, caus- 

these CCWs. 



The status-modi f 
normal effect du 
operation, caus 
subsystem to fete 
CCW whose address 
that of the cu 
applies also to 
i ng that occurs a 
the read operat io 
implicit CCW. 



i er bit has its 
ring the IPL I/O 
ing the channel 
h and chain to the 
is 16 higher than 
rrent CCW. This 
the initial chain- 
fter completion of 
n specified by the 



3. The PSW that is loaded at the 
completion of the IPL operation may 
be provided by the first eight 
bytes of the IPL I/O operation or 
may be placed at absolute locations 
0-7 by a subsequent CCW. 

4. Activating the load-normal key 
implicitly specifies the use of the 
first 24 bytes of main storage and 
the eight bytes at absolute 
locations 184-191. Since the 
remainder of the IPL program may be 
placed in any part of storage, it 
is possible to preserve such areas 
of storage as may be helpful in 
debugging or recovery. When the 
load-clear key is activated, the 
IPL program starts with a cleared 
machine in a known state, except 
that information on external stoi — 
age remains unchanged. 

5. When the PSW at absolute location 
has bit 14 set to one, the CPU is 
placed in the wait state after the 
IPL operation is completed; at that 
point, the load and manual indica- 
tors are off, and the wait 
indicator is on. 



RECONFIGURATION OF THE I/O SYSTEM 



Reconfiguration of the 
handled in a model-dep 
For example, changes may 
program control, by usi 
dependent DIAGNOSE instru 
ally, by using 
configuration controls; 
combination of DIAGNOS 
controls. The method u 
the system model . The 
publication for the syst 
fies how the changes a 



I/O system i s 
endent manner, 
be made under 
ng the model- 
ction; or manu- 
sy stem- ope rat or 
or by using a 
E and manual 
sed depends on 
System Library 
em model speci- 
re made. The 
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partitioning of channel paths because of 
reconfiguration is indicated by the 
setting of the PAM bits in the SCHIB 
stored if STORE SUBCHANNEL is executed 
(see the section "Subchannel-Information 
Block" in Chapter 15, "Basic I/O Func- 
tions"). 



STATUS VERIFICATION 



The status-verification facility pro- 
vides the channel subsystem with a means 
of indicating that a device has 
presented a device-status byte that has 
valid CBC but that contained a combina- 
tion of bits that was inappropriate when 
the status byte was presented to the 
channel subsystem. The indication 
provided to the program in the ESW by 
the channel subsystem is called device- 
status check. When the channel 
subsystem recognizes a device-status- 
check condition, an interface-control- 
check condition is also recognized. For 
a summary of the status combinations 
considered to be appropriate or inappro- 
priate, see the System Library 
publication IBM System/360 and 
System/370 I/O Interface Channel to 
Control Unit OEMI , GA22-6974. 



ADDRESS-LIMIT CHECKING 



The address-limit-checking facility 
provides a storage-protection mechanism 
for I/O data accesses to storage that 
augments key-controlled protection. 
When address-limit checking is used, 
absolute storage is divided into two 
parts by a program-controlled address- 
limit value. I/O data accesses can then 
be optionally restricted to only one of 
the two parts of absolute storage by the 
limit mode at each subchannel. The 
address-limit constraint operates at a 
higher priority than key-controlled 
protection so that I/O data accesses to 
the protected part of main storage are 
prevented even when the subchannel key 
is zero or matches the key in storage. 

The address-limit-checking facility 
consists of the following elements: 



The I/O 
LIMIT. 



instruction SET ADDRESS 



• The limit mode at each subchannel. 

• The address-limit-checking-control 
bit in the ORB. 

Execution of SET ADDRESS LIMIT passes 
the contents of general register 1 to 
the address-limit-checking facility to 
be used as the address-limit value. 
Bits and 16-31 of general register 1 
must contain zeros to designate a valid 



absolute address on a 64K-byte boundary; 
otherwise, an operand exception is 
recognized, and execution of the 
instruction is suppressed. 

The limit mode at each subchannel indi- 
cates the manner in which address-limit 
checking is to be performed. The limit 
mode is set by placing the desired value 
in bits 9-10 of word 1 in the SCHIB and 
executing MODIFY SUBCHANNEL. The 
settings of these bits in the SCHIB have 
the following meanings: 



00 No limit 
value) . 



checking (initialized 



01 Data address must be equal to 
or greater than the current 
address limit. 

10 Data address must be less than 
the current address limit. 

11 Reserved. This combination of 
limit-mode bits causes an oper- 
and exception to be recognized 
when MODIFY SUBCHANNEL is 
executed. 

The address-limit-checking-control bit 
in the ORB (bit 11 of word 1) specifies 
whether address-limit checking is to be 
used for the start function that is 
accepted when execution of START 
SUBCHANNEL causes the contents of the 
ORB to be passed to the subchannel. If 
the address-limit-checking-control bit 
is zero when the contents of the ORB are 
passed, address-limit checking is not 
specified for that start function. If 
the bit is one, address-limit checking 
is specified and is under the control of 
the current address limit and the 
current setting of the limit mode at the 
subchannel . 

During the performance of the start 
function, an attempt to access an abso- 
lute storage location for data that is 
protected by an address limit (either 
high or low) is recognized as an 
address-limit violation, and the access 
is not allowed. A program-check condi- 
tion is recognized, and channel-program 
execution is terminated, just as when an 
attempt is made to access an invalid 
address. 



CONFIGURATION ALERT 



The configuration 
provides a detect i 
devices that are not 
subchannel in the c 
conf i gurati on-alert 
the program by means 
that a device which 
with a subchannel 
communicate with the 
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has attempted to 

program. 
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Each device must be assigned to a 
subchannel during an installation proce- 
dure; otherwise* the channel subsystem 
is unable to generate an 1/0- 
interruption condition for the device. 
This is because the I/O-i nterrupt i on 
code contains the subchannel number 
which identifies the particular device 
causing the I/O-i nterrupti on condition. 
When a device that is not associated 
with a subchannel attempts to communi- 
cate with the channel subsystem, the 
configuration-alert facility generates a 
channel report in which the unassociated 
device is identified. For a description 
of the means by which the program is 
notified of a pending channel report and 
how the information in the channel 
report is retrieved, see the section 
"Channel Report" later in this chapter. 



INCORRECT-LENGTH-INDICATION SUPPRESSION 



The incorrect-length-indication- 

suppression facility allows the indi- 
cation of incorrect length for immediate 
operations to be suppressed in the same 
manner when using format-1 CCWs as when 
using format-0 CCWs or CCWs in the 
System/370 mode. When the incorrect- 
length-i ndi cat i on- suppress ion faci li ty 
is installed, bit 24, word 1 of the ORB 
specifies whether the channel subsystem 
is to suppress the indication of incoi — 
rect length for an immediate operation 
when format-1 CCWs are used or whether 
this indication will remain under the 
control of the SLI flag of the current 
CCW (as is the case for CCWs not 
executed as immediate operations). This 
bit provides the capability for a chan- 
nel program to operate in the same 
manner regarding the indication of 
incorrect length regardless of whether 
format-0 or format-1 CCWs are used. 



CHANNEL-SUBSYSTEM RECOVERY 



I The channel subsystem provides a recov- 
j ery mechanism for extensive detection of 
I malfunctions and other conditions to 
ensure the integrity of channel- 
subsystem operation and to achieve auto- 
matic recovery of some malfunctions. 
Various reporting methods are used by 
the channel-subsystem recovery mechanism 
to assist in program recovery, mainte- 
nance, and repair. 

The method used to report a particular 
malfunction or other condition is 
dependent upon the severity of the 
malfunction or other condition and the 
degree to which the malfunction or other 
I condition can be isolated. A malfunc- 



| tion or other condition in the channel 
I subsystem may be indicated to the 

program by information being stored by 

one of the following methods: 

1. Information is provided in the IRB 
describing a condition that has 
been recognized by either the chan- 
nel subsystem or device that must 
be brought to the attention of the 
program. Generally, this informa- 
tion is made available to the 
program by the execution of TEST 
SUBCHANNEL, which is usually 
executed in response to the occui — 
rence of an I/O interruption. (See 
Chapter 16, "I/O Interruptions," 
for a definition of the information 
stored, as well as Chapter 6, 
"Interrupt i ons.") 

2. Information is provided in a chan- 
nel report describing a machine 
malfunction affecting the identi- 
fied facility within the channel 
subsystem. This information is 
made available to the program by 
the execution of STORE CHANNEL 
REPORT WORD, which is usually 
executed in response to the occui — 
rence of a machine-check interrup- 
tion. (See Chapter 11, "Machine- 
Check Handling," for a description 
of the machine-check-interruption 
mechanism and the contents of the 
machi ne-check-i nterrupti on code. ) 

3. Information is provided in a chan- 
| nel report describing a malfunction 
I or other condition affecting a 

collection of channel-subsystem 
facilities. This information is 
made available to the program as 
indicated in item 2. 

4. Information is provided in the 
machine-check-interruption code 
(MCIC) describing a malfunction 
affecting the continued operational 
integrity of the channel subsystem. 
(See the section "Channel-Subsystem 
Damage" in Chapter 11, "Machine- 
Check Handling.") 

5. Information is provided in the MCIC 
describing a malfunction affecting 
the continued operational integrity 
of a process or of the system. 
(See the sections "Instruction- 
Processing Damage" and "System 
Damage" in Chapter 11, "Machine- 
Check Handling.") 

I Channel reports are used to report 
| malfunctions or other conditions only 
| when the use of the I/O-interrupti on 
facility is not appropriate and in pref- 
erence to reporting channel-subsystem 
damage, instruction-processing damage, 
or system damage. 
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CHANNEL REPORT 



When a malfunction or other condition 
affecting elements of the channel 
subsystem has been recognized, a channel 
report is generated. Execution of 
recovery actions by the program or by 
external means may be required to gain 
I recovery from the error condition. The 
I channel report indicates the source of 
the channel report and the recovery 
state to the extent necessary for detei — 
mining the proper recovery action. A 
channel report consists of one or more 
channel-report words (CRWs) that have 
been generated from an analysis of the 
malfunction or other condition. The 
inclusion of two or more CRWs within a 
channel report is indicated by the 
chaining flag being stored as one in all 
of the CRWs of the channel report except 
the last one in the chain. 

When a channel report is made pending by 
the channel subsystem for retrieval and 
analysis by the program (by means of the 
execution of STORE CHANNEL REPORT WORD), 
a malfunction or other condition that 
affects the normal operation of one or 
more of the channel-subsystem facilities 
has been recognized. If the channel 
report that is made pending is an 
initial channel report, a machine- 
check-interruption condition is 
generated that indicates one or more 
CRWs are pending at the channel subsys- 
tem. A channel report is initial either 
if it is the first channel report to be 
| generated after the most recent 1/0- 
I system reset or i f no previously 
generated reports are pending and the 
last STORE CHANNEL REPORT WORD instruc- 
tion that was executed resulted in the 
setting of condition code 1, indicating 
that no channel report was pending. 
When the machine-check interruption 
occurs and bit 9 of the machine-check- 
interruption code (channel report 
pending) is one, a channel report is 
pending. If the program clears the 
first CRW of a channel report before the 
associated machine-check interruption 
has occurred* some models may reset the 
machi ne- check- i nterruption condition, 
and the associated machine-check intei — 
ruption does not occur. A machine-check 
interruption indicating that a channel 
report is pending occurs only if the 
machine-check mask (PSW bit 13) and the 
channel-report-pending subclass mask 
(bit 3 of control register 14) are both 
ones. 

If the channel report that is made pend- 

iing is not an initial channel report, a 
machine-check-interruption condition is 
I not generated. 

The CRW that i s presented to the program 
in response to the first STORE CHANNEL 
REPORT WORD instruction that is executed 
after a machine-check interruption may 
or may not be part of the initial chan- 



nel report that caused the machine-check 
condition to be generated. A pending 
channel-report word is cleared by any 
CPU executing STORE CHANNEL REPORT WORD, 
regardless of whether a machine-check 
interruption has occurred in any CPU. 
If a CRW is not pending and STORE CHAN- 
NEL REPORT WORD is executed, condition 
code 1 is set, and zeros are stored at 
the location designated by the second- 
operand address. During execution of 
STORE CHANNEL REPORT WORD as a result of 
receiving a machine-check interruption, 
condition code 1 may be set, and zeros 
may be stored because (1) the related 
channel report has been cleared by 
another CPU or (2) a malfunction 
occurred during the generation of a 
channel report. In the latter case, if, 
during a subsequent attempt, a valid 
channel report can be made pending, an 
addi ti onal machi ne-check-i nterrupti on 
condition is generated. 

When a channel report consists of multi- 
ple chained CRWs, they are presented to 
the program in the same order that they 
are placed in the chain by the channel 
subsystem as the result of consecutive 
executions of STORE CHANNEL REPORT WORD. 
If, for example, the first CRW of a 
chain is presented to the program as a 
result of executing STORE CHANNEL REPORT 
WORD, then the CRW that is presented as 
a result of the next execution of STORE 
CHANNEL REPORT WORD is the second CRW of 
the same chain, and not a CRW that is 
part of another channel report. 

Channel reports are not presented to the 
program in any special order, except for 
channel reports whose first or only CRW 
indicates the same report i ng-source code 
and the same reporti ng-source ID. These 
channel reports are presented to the 
program in the same order that they are 
generated by the channel subsystem, but 
they are not necessarily presented 
consecutively. For example, suppose the 
channel subsystem generates channel 
reports A, B, and C, in that order. The 
first CRW of channel reports B and C 
indicates the same reporti ng-source code 
and the same reporti ng-source ID. Chan- 
nel report B i s presented to the program 
before channel report C is presented, 
but channel report A may be presented 
after channel report B and before chan- 
nel report C. 



Programming Notes 



The information that is provided in 
a single CRW may be made obsolete 
by another CRW that is subsequently 
generated for the same channel- 
subsystem facility. Therefore, the 
information that is provided in one 
channel report should be interpret- 
ed in light of the information 
provided by all of the channel 
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reports that are pending at a 
instant. 



gi ven 



A machine-check-interruption condi- 
tion is not always generated when a 
channel report is made pending. 
The conditions that result in a 
machi ne-check-i nterrupti on condi - 
tion being generated are described 
earlier in this section. 

After a machine-check interruption 
has occurred with bit 9 of the 
machine-check-interruption code set 
to one, STORE CHANNEL REPORT WORD 
should be executed repeatedly until 
all of the pending channel reports 
have been cleared and condition 
code 1 has been set. 

A CRW-overflow condition can occur 
if the program does not execute 
successive STORE CHANNEL REPORT 
WORD instructions in a timely 
manner after the machine-check 
interruption occurs. 

The number of CRWs that can be 
pending at the same time is model- 
dependent. During the existence of 
an overflow condition, CRWs that 
would have otherwise been made 
pending are lost and are never 
presented to the program. 



CHANNEL-REPORT WORD (CRW) 



The channel-report word (CRW) provides 
information to the program that can be 
used to facilitate the recovery of an 
I/O operation, a device, or some element 
of the channel subsystem, such as a 
channel path or subchannel. The format 
of the CRW is as follows. Bits and 
8-9 are reserved and are always stored 
as zeros. 






s 


R 


C 


RSC 


00 


ERC 


Reporti ng-source 
ID 



1231 



8 10 



16 



Sol i ci ted 
i ndi cates 
consi dered 
be solicit 
the direct 
taken by 
zero, the 
been made 
action ta 
that is in 



CRW (S) 
a solic 
by the 

ed i f i 
result 

the pro 
CRW is 
pendi ng 

ken by 

dependen 



: Bit 
ited CRW 

channel 

t i s mad 

of some a 

gram. Wh 

unsoli c 

as the 
the chann 
t of the 



31 



1, when one, 
A CRW is 
subsystem to 
e pending as 
ction that is 
en bit 1 is 
ited and has 
result of an 
el subsystem 
program. 



Overflow (R) : Bit 2, when one, indi- 
cates that a CRW-overflow condition has 
been recognized since this CRW became 
pending and that one or more CRWs have 
been lost. This bit is one in the CRW 
that has most recently been set pending 
when the overflow condition is recog- 
nized. When bit 2 is zero, a CRW- 
overflow condition has not been 
recogni zed. 

A CRW that is part of a channel report 
is not made pending, even though the 
overflow condition does not exist, if an 
overflow condition prevented a previous 
CRW of that report from being made pend- 
ing. 

Chai ni ng (C) : Bit 3, when one, and when 
the overflow flag is zero, indicates 
chaining of associated CRWs. Chaining 
of CRWs is indicated whenever a malfunc- 
tion or other condition is described by 
more than a single CRW. The chaining 
flag is zero if the channel report is 
described by a single CRW or if the CRW 
is the last CRW of a channel report. 



The chaining flag is 
the overflow bit, bit 



not meaningful 
2, is one. 



if 



Reporti ng-Source Code ( RSC ) : Bits 4-7 
identify the channel-subsystem facility 
that has been associated with the 
malfunction or other condition. Some 
facilities &rG further identified in the 
reporti ng- source- i dent if i cat i on f i eld 
(see below). The following combinations 
of bits identify the facilities: 

Bits 
i 5 6 7 Desi gnati on 

10 Monitoring facility 

11 Subchannel 

10 Channel path 

10 1 Configuration-alert facility 

All other bit combinations in the 
reporti ng-source-code field are 
reserved. 

Error-Recovery Code ( ERC ) : Bits 10-15 
contain the erroi — recovery code which 
defines the recovery state of the 
channel-subsystem facility identified in 
the reporti ng-source code. This field, 
when used in conjunction with the 
reporti ng-source code, can be used by 
the program to determine whether the 
identified facility has already been 
recovered and is available for use or 
whether recovery actions are still 
required. The following erroi — recovery 
codes are possible: 
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Bits 
10 11 12 13 14 15 


















1 














1 

















1 


1 











1 

















1 





1 











1 


1 






State 

Avai lable 
Ini tiali zed 
Temporary error 
Installed parameters 

initiali zed 
Termi nal 
Permanent error with 

facility not 

initiali zed 
Permanent error with 

faci li ty 

i ni tial i zed 



All other bit combinations in the 
error-recovery-code field are reserved. 

The specific meaning of each erroi — 
recovery code depends on the particular 
report i ng-source code that accompanies 
it in a CRW. The erroi — recovery codes 
are defined as follows* 

Avai lable ? The identified facility 
is in the same state that the 
program would expect if the CRW had 
not been generated. 

Ini ti ali ze d? The identified facil- 
ity is in the same state that 
existed immediately following the 
I/0-system reset that was part of 
the most recent system IPL. 

Temporary : The identified facility 
is not operating in a normal manner 
or has recognized the occurrence of 
an abnormal event. It is expected 
that subsequent actions either will 
restore the facility to normal 
operation or will record the appro- 
priate information describing the 
abnormal event. 

Installe d Parameters Ini ti ali zed : 
Thi s state i s the same as the 
initialized state, except that one 
or more parameters that are associ- 
ated with the facility and that are 



not modifiable by 
have been changed. 



the program may 



Termi nal : The identified facility 
is in a state such that an opera- 
tion which was in progress can 
neither be completed nor terminated 
in the normal manner. 

Permanent Error Hi th Faci 1 i ty Not 
Ini ti al i zed : The identified facil- 
ity is in a state of malfunction, 
and the channel subsystem has not 
caused a reset function to be 
performed for that facility. 

Permanent Error Mi th Faci 1 i ty 
Ini ti al i zed ? The identified facil- 
ity is in a state of malfunction, 
and the channel subsystem has 
caused or may have caused a reset 
function to be performed for that 
faci 1 i ty . 



Reporti ng-Sou 
contain the 
may, dependin 
other condit 
source code, 
affected cha 
provide addit 
ing the malfu 
The RSID fiel 
as a function 
reporti ng-sou 



rce ID (RSID): 



B 



reporti ng-source 
g upon the malfu 
i on and on the r 
either further i de 
nnel-subsystem fac 
ional information 
nction or other c 
d has the folloui 
of the bit settin 
rce code. 



its 16-31 
ID which 
nction or 
eporti ng- 
ntify the 
i 1 i ty or 
descri b- 
ondi ti on . 
ng format 
gs of the 



Reporti ng- 
Source Code 

4 5 6 7 



Reporti ng-Sou rce ID 

Bits 16-31 

0000 0000 0000 0000 

XXXX XXXX XXXX XXXX 

0000 0000 YYYY YYYY 

0000 0000 YYYY YYYY 



Notes: 



X = Subchannel number 

Y = Channel-path ID (CHPID) 
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APPENDIX *> . NUMBER REPRESENTATION AND INSTRUCTION-USE EXAMPLES 



Number Representation A-2 

Binary Integers A~2 

Signed Binary Integers A-2 

Unsigned Binary Integers A~4 

Decimal Integers A-5 

Floating-Point Numbers A~5 

Conversion Example A-7 

Instruction-Use Examples A-7 

Machine Format A-7 

Assemble! — Language Format A-7 

Addressing Mode in Examples A-8 

General Instructions A-8 

ADD HALFWORD (AH) A-8 

AND (N, NC, NI, NR) A-8 

NI Example .A-8 

Linkage Instructions (BAL, BALR, BAS, BASR, BASSM, 

BSM) A-9 

Other BALR and BASR Examples A-10 

BRANCH ON CONDITION (BC, BCR) A-10 

BRANCH ON COUNT (BCT, BCTR) A-ll 

BRANCH ON INDEX HIGH (BXH) A-ll 

BXH Example 1 A-ll 

BXH Example 2 A-ll 

BRANCH ON INDEX LOW OR EQUAL (BXLE) A-12 

BXLE Example 1 A-12 

BXLE Example 2 A-12 

COMPARE HALFWORD (CH) A-13 

COMPARE LOGICAL (CL, CLC, CLI, CLR) A-13 

CLC Example A-13 

CLI Example A-14 

CLR Example A-14 

COMPARE LOGICAL CHARACTERS UNDER MASK (CLM) A-14 

COMPARE LOGICAL LONG (CLCL) A-14 

CONVERT TO BINARY (CVB) A-16 

CONVERT TO DECIMAL (CVD) A-16 

DIVIDE (D, DR) A-16 

EXCLUSIVE OR (X, XC, XI, XR) A-17 

XC Example A-17 

XI Example A-18 

EXECUTE (EX) A-18 

INSERT CHARACTERS UNDER MASK (ICM) A-19 

LOAD (L, LR) A-20 

LOAD ADDRESS (LA) A-20 

LOAD HALFWORD (LH) , A-20 

MOVE (MVC, MVI) A-21 

MVC Example A-21 

MVI Example A-21 

MOVE INVERSE (MVCIN) A-22 

MOVE LONG (MVCL) A-22 

MOVE NUMERICS (MVN) A-23 

MOVE WITH OFFSET (MVO) A-23 

MOVE ZONES (MVZ) A-24 

MULTIPLY (M, MR) A-24 

MULTIPLY HALFWORD (MH) A-24 

OR (0, OC, 01, OR) A-25 

01 Example A-25 

PACK (PACK) A-25 

SHIFT LEFT DOUBLE (SLDA) A-26 

SHIFT LEFT SINGLE (SLA) A-26 

STORE CHARACTERS UNDER MASK (STCM) A-26 

STORE MULTIPLE (STM) A-27 

TEST UNDER MASK (TM) A-27 

TRANSLATE (TR) A-28 

TRANSLATE AND TEST (TRT) A-28 

UNPACK (UNPK) A-30 

Decimal Instructions A-30 

ADD DECIMAL (AP) A-30 

COMPARE DECIMAL (CP) A-31 
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DIVIDE DECIMAL (DP) A-31 

EDIT (ED) A-31 

EDIT AND MARK (EDMK) A-33 

MULTIPLY DECIMAL (MP) A-34 

SHIFT AND ROUND DECIMAL (SRP) A-34 

Decimal Left Shift A-34 

Decimal Right Shift A-35 

Decimal Right Shift and Round A-35 

Multiplying by a Variable Power of 10 A-35 

ZERO AND ADD (ZAP) A-36 

Floating-Point Instructions A-36 

ADD NORMALIZED (AD, ADR, AE, AER, AXR) A-36 

ADD UNNORMALIZED (AU, AUR, AW, AWR) A-36 

COMPARE (CD, CDR, CE, CER) A-37 

DIVIDE (DD, DDR, DE, DER) A-37 

HALVE (HDR, HER) A-38 

MULTIPLY (MD, MDR, ME, MER, MXD, MXDR, MXR) A-38 

Floating-Point-Number Conversion A-38 

Fixed Point to Floating Point A-39 

Floating Point to Fixed Point A-39 

Multiprogramming and Multiprocessing Examples A-40 

Example of a Program Failure Using OR Immediate A-40 

Conditional Swapping Instructions (CS, CDS) A-40 

Setting a Single Bit A-41 

Updating Counters A-41 

Bypassing POST and WAIT A-42 

BYPASS POST Routine A-42 

BYPASS WAIT Routine A-42 

LOCK/UNLOCK A-42 

LOCK/UNLOCK with LIFO Queuing for Contentions A-43 

LOCK/UNLOCK with FIFO Queuing for Contentions A-44 

Free-Pool Manipulation A-45 



NUMBER REPRESENTATION 



BINARY INTEGERS 



Negative binary 
two * s-complement 
each bit of the 
and adding one. 
halfword format, 
the decimal 
(-26) in the 



integers are formed in 
notation by inverting 
positive binary integer 
As an example using the 
the binary number with 

value +26 is made negative 

following manner: 



Si qned Bi nary Integers 



Signed binary integers are most commonly 
represented as halfwords (16 bits) or 
words (32 bits). In both lengths, the 
leftmost bit (bit 0) is the sign of the 
number. The remaining bits (bits 1-15 
for halfwords and 1-31 for words) are 
used to specify the magnitude of the 
number. Binary integers are also 
referred to as fixed-point numbers, 
because the radix point (binary point) 
is considered to be fixed at the right, 
and any scaling is done by the program- 
mer. 



+26 000 0000 0001 1010 
Invert 1 111 1111 1110 0101 
Add 1 1 



-26 



1 111 1111 1110 0110 (Two's 

complement 
form) 



(S is the sign bit.) 

This is equivalent to subtracting the 
number : 



from 



00000000 00011010 
1 00000000 00000000 



Positive binary integers are in true 
binary notation with a zero sign bit. 
Negative binary integers are in two's- 
complement notation with a one bit in 
the sign position. In all cases, the 
bits between the sign bit and the left- 
most significant bit of the integer are 
the same as the sign bit (that is, all 
zeros for positive numbers, all ones for 
negative numbers). 



Negative binary integers are changed to 
positive in the same manner. 

The following addition examples illus- 
trate two' s-complement arithmetic and 
overflow conditions. Only eight bit 
positions are used. 

1. +57 = 0011 1001 
+35 = 0010 0011 



+92 = 0101 1100 
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2. +57 
-35 



0011 1001 
1101 1101 



+ 22 = 0001 0110 No overflow — carry 
into leftmost posi- 
tion and carry out 



3. +35 = 0010 0011 
-57 = 1100 0111 



-22 = 1110 1010 Sign change only — 
no carry into left- 
most position and no 
carry out 



-57 = 1100 0111 
-35 = 1101 1101 



-92 = 1010 0100 No overflow — carry 
into leftmost posi- 
tion and carry out 



5. +57 = 0011 1001 
+92 = 0101 1100 

+149 =*1001 0101 ^Overflow -- carry 
into leftmost posi- 
tion* no carry out 



6. -57 = 1100 0111 
-92 = 1010 0100 



-149 =*0110 1011 ^Overflow — no carry 
into leftmost posi- 
tion but carry out 

The presence or absence of an overflow 
condition may be recognized from the 
carri es: 



• There is no overflow: 

a. If there is no carry into the 
leftmost bit position and no 
carry out (examples 1 and 3). 

b. If there is a carry into the 
leftmost position and also a 
carry out (examples 2 and 4). 

• There is an overflow: 

a. If there is a carry into the 
leftmost position but no carry 
out (example 5). 

b. If there is no carry into the 
leftmost position but there is 
a carry out (example 6). 

The following are 16-bit signed binary 
integers. The first is the maximum 
positive 16-bit binary integer. The 
last is the maximum negative 16-bit 
binary integer (the negative 16-bit 
binary integer with the greatest abso- 
lute value) . 



2 15 

2° 



■2° 
•2 15 



-1 = 32,767 = 111 1111 1111 1111 

= 1 = 000 0000 0000 0001 

= = 000 0000 0000 0000 

= -1=1 111 1111 1111 1111 

= -32,768 = 1 000 0000 0000 0000 



The figure "32-Bit Signed Binary Inte- 
gers" illustrates several 32-bit signed 
binary integers arranged in descending 
order. The first is the maximum posi- 
tive binary integer that can be repres- 
ented by 32 bits, and the last is the 
maximum negative binary integer that can 
be represented by 32 bits. 



2 31. 


-1 


— 


2 


147 


483 


647 


— 





111 


1111 


1111 


1111 


1111 


1111 


1111 


1111 


2 i t> 




= 






65 


536 


r 





000 


0000 


0000 


0001 


0000 


0000 


0000 


0000 


2° 




— 








1 


s: 





000 


0000 


0000 


0000 


0000 


0000 


0000 


0001 







^ 











r 





000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


-2° 




= 








-1 


r 


1 


111 


1111 


1111 


1111 


1111 


1111 


1111 


1111 


-2 1 




— 








-2 


= 


1 


111 


1111 


1111 


1111 


1111 


1111 


1111 


1110 


_ 2 i* 




s 






-65 


536 


= 


1 


111 


1111 


1111 


1111 


0000 


0000 


0000 


0000 


-2 31 +1 


s 


-2 


147 


483 


647 


= 


1 


000 


0000 


0000 


0000 


0000 


0000 


0000 


0001 


_ 2 31 




= 


-2 


147 


483 


648 


= 


1 


000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 
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Unsigned Binary Integers 



Certain instructions* such as ADD 
LOGICAL, treat binary integers as 
unsigned rather than signed. Unsigned 
binary integers have the same format as 
signed binary integers, except that the 
leftmost bit is interpreted as another 
numeric bit rather than a sign bit. 
There is no complement notation because 
all unsigned binary integers are consid- 
ered positive. 

The following examples illustrate the 
addition of unsigned binary integers. 
Only eight bit positions are used. The 
examples are numbered the same as the 
corresponding examples for signed binary 
i ntegers. 

1. 57 = 0011 1001 
35 = 0010 0011 

92 = 0101 1100 



2. 57 = 0011 1001 
221 = 1101 1101 

278 =*0001 0110 xcarry out of 

leftmost position 



3. 35 = 0010 0011 
199 = 1100 0111 

234 = 1110 1010 



4. 199 = 1100 0111 
221 = 1101 1101 



5. 



420 =*1010 0100 xcarry out of 

leftmost position 



57 = 0011 1001 
92 = 0101 1100 



149 = 1001 0101 



6. 199 = 1100 0111 
164 = 1010 0100 

363 =*0110 1011 xcarry out of 

leftmost position 

A carry out of the leftmost bit position 
may or may not imply an overflow, 
depending on the application. 

The figure "32-Bit Unsigned Binary Inte- 
gers" illustrates several 32-bit 
unsigned binary integers arranged in 
descending order. 



232-! 


= 


4 


294 


967 


295 


2 31 


— 


2 


147 


483 


648 


2 3l -l 


- 


2 


147 


483 


647 


2i* 


= 






65 


536 


2° 


s 








1 





r: 












1111 1111 1111 1111 1111 1111 1111 1111 

1000 0000 0000 0000 0000 0000 0000 0000 

0111 1111 1111 1111 1111 1111 1111 1111 

0000 0000 0000 0001 0000 0000 0000 0000 

0000 0000 0000 0000 0000 0000 0000 0001 

0000 0000 0000 0000 0000 0000 0000 0000 
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DECIMAL INTEGERS 



Decimal integers consist of 
decimal digits and a sign, 
and the sign are represente 
code. The decimal digi 
binary-coded decimal (BCD) 
the values 0-9 encoded as 
The sign is usually represe 
(C hex) for plus and 1101 
minus. These are the pre 
codes* which are generat 
machine for the results 
arithmetic operations. The 
several alternate sign c 
1110, and 1111 for plus 
minus). The alternate sig 
accepted by the machine a 
source operands but are no 
for results- 



one or more 

Each digit 

d by a 4-bit 

ts are in 

form, with 
0000-1001. 
nted as 1100 
(D hex) for 
f erred sign 
ed by the 
of decimal- 
re are also 
odes (1010, 
; 1011 for 
n codes are 
s vali d i n 
t generated 



Decimal integers may 
lengths, from one to 
&re two decimal forma 
zoned. In the packed 
contains two decimal d 
the rightmost byte, wh 
sign code in the right 
mal arithmetic, the n 
digits in the packed 
from one to 31. Becau 
gers must consist of 
there must be a sign c 
the number of decimal 
odd. If an even numbe 
digits is desired, a 1 
be inserted on the left 



have different 
16 bytes. There 
ts: packed and 
format, each byte 
igits, except for 
i ch contains the 

half. For deci- 
umber of decimal 

format can vary 
se decimal inte- 

whole bytes and 
ode on the right, 
digi ts i s always 
r of significant 
eading zero must 



In the zoned format, each byte consists 
of a decimal digit on the right and the 
zone code 1111 (F hex) on the left, 
except for the rightmost byte where the 
sign code replaces the zone code. Thus, 
a decimal integer in the zoned format 
can have from one to 16 digits. The 
zoned format may be used directly for 
input and output in the extended 
binary-coded-decimal interchange code 
(EBCDIC), except that the sign must be 
separated from the rightmost digit and 
handled as a separate character. For 
positive (unsigned) numbers, however, 
the sign can simply be represented by 
the zone code of the rightmost digit 
because the zone code is one of the 
acceptable alternate codes for plus. 

In either format, negative decimal inte- 
gers are represented in true notation 
with a separate sign. As for binary 
integers, the radix point (decimal 
point) of decimal integers is considered 
to be fixed at the right, and any scal- 
ing is done by the programmer. 

The following are some examples of deci- 
mal integers shown in hexadecimal nota- 
tion: 



Decimal 
Value 


Packed 
Format 




Zoned 

Format 








+ 123 


12 
or 
12 


3C 

3F 






Fl 
or 
Fl 


F2 
F2 


C3 

F3 








-4321 


04 


32 


ID 




F4 


F3 


F2 


Dl 






+000050 


00 


00 


05 


OC 


F0 


F0 


F0 


F0 


F5 


CO 




or 
00 


00 


05 


OF 


or 
F0 


FO 


F0 


FO 


F5 


F0 


-7 


7D 








D7 












00000 


00 


00 


OC 




F0 


F0 


F0 


F0 


CO 






or 
00 


00 


OF 




or 
F0 


F0 


F0 


F0 


F0 





Under some circumstances, a zero with a 
minus sign (negative zero) is produced. 
For example, the multiplicand: 

00 12 3D (-123) 
times the multiplier: 

0C (+0) 
generates the product: 

00 00 0D (-0) 

because the product sign follows the 
algebraic rule of signs even when the 
value is zero. A negative zero, 
however, is equivalent to a positive 
zero in that they compare equal in a 
decimal comparison. 



FLOATING-POINT NUMBERS 



A floating-point number is expressed as 
a hexadecimal fraction multiplied by a 
separate power of 16. The term floating 
point indicates that the placement, of 
the radix (hexadecimal) point, or scal- 
ing, is automatically maintained by the 
machi ne. 

The part of a floating-point number 
which represents the significant digits 
of the number is called the fraction. A 
second part specifies the power (expo- 
nent) to which 16 is raised and indi- 
cates the location of the radix point of 
the number. The fraction and exponent 
may be represented by 32 bits (short 
format), 64 bits (long format), or 128 
bits (extended format). 

Short Floating-Point Number 



Characteri sti c 



6-Digit Fraction 

/ 



1 



31 
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Long Floating-Point Number 



Character! sti c 



14-Digit Fraction 
/ 



1 



Extended Floating-Point Number 

High-Order Part 

/ 



63 



Hi gh-Order 
Characteri sti c 



Leftmost 14 Digits 
of 28-Digit Fraction 

/ ■ — 



8 



Low-Order Part 



63 



Low-Order 
Characteri sti c 



Rightmost 14 Digits 
of 28-Digit Fraction 

/ 



64 

A floating- 
one for th 
exponent, 
also the s 
the leftmos 
plus, 1 for 
the fractio 
less of th 
contai ned 
format, in 
format, an 
bits 72-127 



72 



127 



point number has two signs: 
e fraction and one for the 
The fraction sign, which is 
i gn of the entire number, is 
t bit of each format (0 for 

minus). The numeric part of 
n is in true notation regard- 
e sign. The numeric part is 
in bits 8-31 for the short 
bits 8-63 for the long 
d in bits 8-63 followed by 

for the extended format. 



The exponent sign is obtained by 
expressing the exponent in excess-64 
notation; that is, the exponent is added 
as a signed number to 64. The resulting 
number is called the characteristic. It 
is located in bits 1-7 for all formats. 
The characteristic can vary from to 
127, permitting the exponent to vary 
from -64 through to +63. This 
provides a scale multiplier in the range 
of 16-** to 16+ 63 . A nonzero fraction, 
if normalized, has a value less than one 
and greater than or equal to 1/16, so 



that the range covered by the magnitude 
M of a normalized floating-point number 
i s: 



16 



-65 



< M < 16 



63 



In decimal terms: 

16~ 65 is approximately 5.4 x 10~ 79 

16 63 is approximately 7.2 x 10 75 
More precisely, 
In the short format: 

16" 65 < M < (1 - 16"*) x 16* 3 
In the long format: 

16~* 5 < M < (1 - 16" 1 *) x 16 63 
In the extended format: 

16~ 65 < M < (1 - 16" 28 ) x 16 63 

Within a given fraction length (6, 14, 
or 28 digits), a floating-point opera- 
tion will provide the greatest precision 
if the fraction is normalized. A frac- 
tion is normalized when the leftmost 
digit (bit positions 8, 9, 10, and 11) 
is nonzero. It is unnormalized if the 
leftmost digit contains all zeros. 

If normalization of the operand is 
desired, the floating-point instructions 
that provide automatic normalization are 
used. This automatic normalization is 
accomplished by left-shifting the frac- 
tion (four bits per shift) until a 
nonzero digit occupies the leftmost 
digit position. The characteristic is 
reduced by one for each digit shifted. 

The figure "Normalized Short Floating- 
Point Numbers" illustrates sample 
normalized short floating-point numbers. 
The last two numbers represent the smal- 
lest and the largest positive normalized 
numbers. 



1.0 



= +1/I6xl6 x 



0.5 = +8/16x16° 

1/64 = +4/16xl6~ l 

0.0 = +0 xl6-* 4 

•15.0 = -15/16x16* 

5.4xl0~ 79 ~ +1/16x16-** 

7.2xl0 75 ~ (l-16- 6 )xl6* 3 



= 100 0001 0001 0000 0000 0000 0000 0000(2} 
= 100 0000 1000 0000 0000 0000 0000 0000(2} 
= 011 1111 0100 0000 0000 0000 0000 0000(2} 
= 000 0000 0000 0000 0000 0000 0000 0000(2} 
= 1 100 0001 1111 0000 0000 0000 0000 0000(2} 
= 000 0000 0001 0000 0000 0000 0000 0000(2} 
= 111 1111 1111 1111 1111 1111 1111 1111(2} 



[The symbol "* means "approximately equal."] 



Normalized Short Floating-Point Numbers 
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CONVERSION EXAMPLE 



Convert the decimal number 59.25 to a 
short floating-point number. (In anoth- 
er appendix are tables for the convei — 
sion of hexadecimal and decimal integers 
and fractions.) 

1. The number is separated into a 
decimal integer and a decimal frac- 
tion. 

59.25 = 59 plus 0.25 

2. The decimal integer is converted to 
its hexadecimal representation. 



3. 



59(10} = 3BC16} 

The decimal fraction is converted 
to its hexadecimal representation. 

0.25(10} = 0.4(16} 

The integral and fractional parts 

are combined and expressed as a 

fraction times a power of 16 (expo- 
nent) . 

3B.4U6} = 0.3B4U6} x 16* 

The characteristic is developed 
from the exponent and converted to 
binary. 

base + exponent = characteristic 
64+2 = 66 = 1000010 

The fraction is converted to binary 
and grouped hexadecimally. 

.3B4(16} = .0011 1011 0100 

The characteristic and the fraction 
are stored in the short format. 
The sign position contains the sign 
of the fraction. 

S Char Fracti on 

1000010 0011 1011 0100 0000 
0000 0000 



Examples of instruction sequences that 
may be used to convert between signed 
binary integers and floating-point 
numbers are shown in the section 
"Floating-Point-Number Conversion" later 
in this appendix. 



6. 



7. 



INSTRUCTION-USE EXAMPLES 



The following examples illustrate the 
use of many of the unprivileged 
instructions. Before studying one of 
these examples, the reader should 
consult the instruction description. 

The instruction-use examples are written 
principally for assembler-language 



programmers, to be used in conjunction 
with the appropriate assembler-language 
publi cations. 

Most examples present one particular 
instruction, both as it is written in an 
assembler-language statement and as it 
appears when assembled in storage 
(machine format). 

In the instruction-use examples, the 
notation (2}, (10}, or (16} may be used, 
indicating that the preceding number is 
binary, decimal, or hexadecimal, respec- 
tively. 



MACHINE FORMAT 



All machine-format values are given in 
hexadecimal notation unless otherwise 
specified. Storage addresses are also 
given in hexadecimal. Hexadecimal opei — 
ands are shown converted into binary, 
decimal, or both if such conversion 
helps to clarify the example for the 
reader. 



ASSEMBLER-LANGUAGE FORMAT 



In assembler-language statements, regis- 
ters and lengths are presented in deci- 
mal. Displacements, immediate operands, 
and masks may be shown in decimal, hexa- 
decimal, or binary notation; for 
example, 12, X f C*, and B'1100' represent 
the same value. Whenever the value in a 
register or storage location is referred 
to as "not significant," this value is 
replaced during the execution of the 
i nstructi on. 

When SS-format instructions are written 
in the assembler language, lengths are 
given as the total number of bytes in 
the field. This differs from the 
machine definition, in which the length 
field specifies the number of bytes to 
be added to the field address to obtain 
the address of the last byte of the 
field. Thus, the machine length is one 
less than the assembler-language length. 
The assembler program automatically 
subtracts one from the length specified 
when the instruction is assembled. 

In some of the examples, symbolic 
addresses are used in order to simplify 
the examples. In assembler-language 
statements, a symbolic address is 
represented as a mnemonic term written 
in all capitals, such as FLAGS, which 
may denote the address of a storage 
location containing data or program- 
control information. When symbolic 
addresses are used, the assembler 
supplies actual base and displacement 
values according to the programmer's 
specifications. Therefore, the actual 
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values for base and displacement are not 
shown in the assembler-language format 
or in the machine-language format. For 
assembler-language formats, in the 
labels that designate instruction 
fields, the letter "S" is used to indi- 
cate the combination of base and 
displacement fields for an operand 
address. (For example, S2 represents 
the combination of B2 and D2.) In the 
machine-language format, the base and 
di splacement address components are 
shown as asterisks (xxxx). 



Addressi ng Mode i n Examples 



Except where otherwise specified, the 
I examples assume the 24-bit addressing 
I mode. 



After the instruction is executed, 
register 5 contains 00 00 00 17 = 
23(10). Condition code 2 is set to 
indicate a result greater than zero. 



AND (N, NC, NI, NR) 



When the Boolean operator AND is applied 
to two bits, the result is one when both 
bits are one; otherwise, the result is 
zero. When two bytes are ANDed, each 
pair of bits is handled separately; 
there is no connection from one bit 
position to another. The following is 
an example of ANDing two bytes: 

First-operand byte: 0011 0101(2) 
Second-operand byte: 0101 1100(2) 



Result byte: 



0001 0100(2) 



GENERAL INSTRUCTIONS 



(See Chapter 7 for a complete descrip- 
tion of the general instructions.) 



ADD HALFWORD (AH) 



The ADD HALFWORD instruction algebra- 
ically adds the contents of a two-byte 
field in storage to the contents of a 
register. The storage operand is 
expanded to 32 bits after it is fetched 
and before it is used in the add opera- 
tion. The expansion consists in propa- 
gating the leftmost (sign) bit 16 
positions to the left. For example, 
assume that the contents of storage 
locations 2000-2001 are to be added to 
register 5. Initially: 

Register 5 contains 00 00 00 19 = 

25(10). 
Storage locations 2000-2001 contain FF 

FE = -2(10). 
Register 12 contains 00 00 18 00. 
Register 13 contains 00 00 01 50. 

The format of the required instruction 
i s: 



Machine Format 
Op Code R, X a 



D 2 



4A 


5 


D 


C 


6B0 



Assembler Format 

Op Code R, ,D 2 (X 2 ,B 2 ) 



NI Example 



A frequent use of the AND instruction is 
to set a particular bit to zero. For 
example, assume that storage location 
4891 contains 0100 0011(2). To set the 
rightmost bit of this byte to zero 
without affecting the 
following instruction 
(assume that register 8 
48 90): 



other bits, the 
can be used 
contains 00 00 



Machine Format 
Op Code I 3 B, 



D, 



94 


FE 


8 


001 



Assembler Format 
Op Code Di (B t ),I S 



NI 



l(8),X f FE f 



When this instruction is executed, the 
byte in storage is ANDed with the imme- 
diate byte (the I 2 field of the instruc- 
ts on) : 



Location 4891: 
Immediate byte: 



0100 0011(2) 
1111 1110(2) 



Result: 



0100 0010(2) 



The resulting byte, with bit 7 set to 
zero, is stored back in location 4891. 
Condition code 1 is set. 



AH 



5,X'6B0 , (13,12) 
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LINKAGE INSTRUCTIONS (BAL, BALR, BAS, 
BASR, BASSM, BSM) 



Four unprivileged instructions (BRANCH 
AND LINK, BRANCH AND SAVE, BRANCH AND 
SAVE AND SET MODE, and BRANCH AND SET 
MODE) are available, together with the 
unconditional branch (BRANCH ON CONDI- 
TION with a mask of 15), to provide 
linkage between subroutines being 
executed in the problem state. BRANCH 
AND LINK (BAL or BALR) is provided 
primarily for compatibility with 
programs written for the System/370 
mode; BRANCH AND SAVE (BAS or BASR) is 
recommended instead for programs which 
are to be executed in the 370-XA mode. 
The instructions BRANCH AND SAVE AND SET 
MODE (BASSM) and BRANCH AND SET MODE 
(BSM) provide subroutine linkage togeth- 
er with switching between the 24-bit and 
31-bit addressing modes. The use of 
these instructions is discussed in a 
programming note at the end of the 
section "Subroutine Linkage" in Chapter 
5, "Program Execution." 



The following examp 
ation of these ins 
uncondi ti onal-branc 
ON CONDITION (BC o 
15). Assume that 
turn is located at 
tion address, ready 
For the first se 
addressing-mode bi 
initially (24- 
effect). For the s 
is initially 1 
Assume also that g 
to receive the lin 
that general regi 
branch address. 



le compares the opei — 
tructions and of the 
h instruction BRANCH 
r BCR with a mask of 
each instruction in 
the current instruc- 
to be executed next, 
t of examples, the 
t, PSW bit 32, is 
bit addressing in 
econd set, PSW bit 32 
(31-bit addressing), 
eneral register 5 is 
kage information, and 
ster 6 contains the 



The format of the BALR instruction is: 

Machine Format 
Op Code R, R 2 



05 


5 


6 



Assembler Format 
Op Code R, ,R 2 



BALR 



5,6 



The other linkage instructions in the RR 
format have the same format but diffei — 
ent op codes: 

BASR 0D 
BASSM OC 
BSM OB 



For comparison with the RR-format 
instructions, the results of two 
RX-format instructions are also shown. 

The format of the BAL instruction is: 



Machine Format 
Op Code R t X 2 



B 3 



45 


5 





6 


000 



Assembler Format 

Op Code R, ,D 2 (X 2 ,B 2 ) 



BAL 



5,0(0,6) 



The BAS instruction has the same format, 
but the op code is 4D. 

The BCR instruction specifies only one 
regi ster: 



Machine Format 
Op Code M, R 2 



07 


F 


6 



Assembler Format 
Op Code M t ,R 2 



BCR 



15,6 



Assume that: 

Register 5 contains BB BB BB BB. 
Register 6 contains 82 46 8A CE. 
PSW bits 32-63 contain 

00 00 10 D6 (for 24-bit addressing). 

80 00 10 D6 (for 31-bit addressing). 
Condition code is 01(2). 
Program mask is 1100 {2}. 

The effect of executing each instruction 
in turn is as follows: 



24-Bit Mode Initially 
Instruction Regi ster 5 
Before BB BB BB BB 



BCR 15,6 
BAL 5,0(0,6) 
BAS 5,0(0,6) 
BALR 5,6 
BASR 5,6 
BASSM 5,6 
BSM 5,6 



BB BB BB BB 
9C 00 10 DA 
00 00 10 DA 
5C 00 10 D8 
00 00 10 D8 
00 00 10 D8 
3B BB BB BB 



PSW (32-63) 

00 00 10 D6 

00 46 8A CE 

00 46 8A CE 

00 46 8A CE 

00 46 8A CE 

00 46 8A CE 

82 46 8A CE 

82 46 8A CE 
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31-Bit Mode Initially 

Instruction Regi ster 5 PSM (32-63) 

Before BB BB BB BB 80 00 10 D6 



BCR 15,6 
BAL 5,0(0,6) 
BAS 5,0(0,6) 
BALR 5,6 
BASR 5,6 
BASSM 5,6 
BSM 5,6 



BB BB BB BB 82 46 8A CE 



80 00 10 DA 
80 00 10 DA 
80 00 10 D8 
80 00 10 D8 
80 00 10 D8 
BB BB BB BB 



82 46 8A CE 

82 46 8A CE 

82 46 8A CE 

82 46 8A CE 

82 46 8A CE 

82 46 8A CE 



Note that a value of zero in the R 2 
field of any of the RR-format 
instructions indicates that the branch- 
ing function is not to be performed; it 
does not refer to register 0. Likewise, 
a value of zero in the Ri fieid of the 
BSM instruction indicates that the old 
value of PSW bit 32 is not to be saved 
and that register is to be left 
unchanged. Register can be designated 
by the Ri field of instructions BAL, 
BALR, BAS, BASR, and BASSM, however. In 
the RX-format branch instructions, 
branching occurs independent of whether 
there is a value of zero in the B 2 field 
or X 2 field of the instruction. 
However, when the field is zero, instead 
of using the contents of general regis- 
ter 0, a value of zero is used for that 
component of address generation. 



Programming Note 



It should be noted that execution of BAL 
in the 24-bit addressing mode results in 
bit of register 5 being set to one. 
This is because the ILC for an RX-format 
instruction is 10. This is the only 
case in which bit zero of the return 
register does not correctly reflect the 
addressing mode of the caller. Thus, 
BSM may be used to return for BALR, BAS, 
BASR, and BASSM in both the 24-bit and 
the 31-bit addressing modes, but it 
cannot be used to return if the program 
was called by using BAL in the 24-bit 
addressing mode. 



BALR or BASR instruction will be placed 
in register 15, and that the assembler 
may use register 15 as a base register 
until otherwise instructed. (The USING 
statement is an "assembler instruction" 
and is thus not a part of the object 
program. ) 



BRANCH ON CONDITION (BC, BCR) 



The BRANCH ON CONDITION instruction 
tests the condition code to see whether 
a branch should or should not occur. 
The branch occurs only if the current 
condition code corresponds to a one bit 
in a mask specified by the instruction. 



Condition 
Code 

1 
2 
3 



Instruction 

(Mask) Bit 

8 

9 

10 

11 



Mask 
Value 

8 

4 

2 

1 



For example, assume that an ADD (A or 
AR) operation has been performed and 
that a branch to address 6050 is desired 
if the sum is zero or less (condition 
code is or 1). Also assume: 

Register 10 contains 00 00 50 00. 
Register 11 contains 00 00 10 00. 

The RX form of the instruction performs 
the required test (and branch if neces- 
sary) when written as: 



Machine Format 
Op Code Mt X 2 



47 


C | B 


A 


050 



Assembler Format 

Op Code M,,D 2 (X 2 ,B 2 ) 



BC 



12,X»50'(11,10) 



Other BALR and BASR Examples 



The BALR or BASR instruction with the R 2 
field set to zero may be used to load a 
register for use as a base register. 
For example, in the assembler language, 
the two statements: 



BALR 



or 



BASR 



15,0 USING *,15 



15,0 USING *,15 



indicate that the address of the next 
sequential instruction following the 



A mask of 12(10} means that there are 
ones in instruction bits 8 and 9 and 
zeros in bits 10 and 11, so that branch- 
ing takes place when the condition code 
is either or 1. 

A mask of 15 would indicate a branch on 
any condition (an unconditional branch). 
A mask of zero would indicate that no 
branch is to occur (a no-operation). 

(See also the section on "Linkage 
Instructions (BAL, BALR, BAS, BASR, 
BASSM, BSM)" for an example of the BCR 
i nstructi on. ) 
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BRANCH ON COUNT (BCT, BCTR) 



The BRANCH ON COUNT instruction is often 
used to execute a program loop for a 
specified number of times. For example* 
assume that the following represents 
some lines of coding in an assembler- 
language program: 



LUPE AR 8,1 



BACK BCT 6, LUPE 



where register 6 contains 00 00 00 03 
and the address of LUPE is 6826. Assume 
that, in order to address this location, 
register 10 is used as a base register 
and contains 00 00 68 00. 

The format of the BCT instruction is: 



Machine Format 
Op Code R, X a 



46 


6 





A 


026 



Assembler Format 

Op Code R, ,D 2 (X 2 ,B 3 ) 



Register 10 contains 00 00 71 30 = the 
branch address. 

The format of the BXH instruction is: 



Machine Format 
Op Code R, R 3 



86 


4 


6 


A 


000 



Assembler Format 

Op Code R t ,R 3 ,D 2 (B 2 ) 



BXH 



4,6,0(10) 



BCT 



6,X f 26»(0,10) 



When the instruction is executed, first 
the contents of register 6 are added to 
register 4, second the sum is compared 
with the contents of register 7, and 
third the decision whether to branch is 
made. After execution: 

Register 4 contains 00 00 00 8C = 

140U0K 
Registers 6 and 7 are unchanged. 

Since the new value in register 4 is not 
yet greater than the value in register 
7, the branch to address 7130 is not 
taken. Repeated use of the instruction 
will eventually cause the branch to be 
taken when the value in register 4 
reaches 172(10}. 



BXH Example 2 



The effect of the coding is to execute 
three times the loop defined by the 
instructions labeled LUPE through BACK, 
while register 6 is decremented from 
three to zero. 



When the register used to contain the 
increment is odd, that register also 
becomes the compare-value register. The 
following assembler-language subroutine 
illustrates how this may be used to 
search a table. 



BRANCH ON INDEX HIGH (BXH) 



BXH Example 1 



The BRANCH ON INDEX HIGH instruction is 
an index-incrementing and loop- 
controlling instruction that causes a 
branch whenever the sum of an index 
value and an increment value is greater 
than some compare value. For example, 
assume that: 



Register 4 contains 00 
138(10} = the index. 

Register 6 contains 00 00 
= the increment. 

Register 7 contains 00 
170(10} = the compare 



00 00 8A = 
00 02 = 2(10} 



00 00 
value. 



AA = 



Table 


2 Bytes 


2 Bytes 


ARGl 
ARG2 
ARG3 
ARG4 
ARG5 
ARG6 


FUNCTl 
FUNCT2 
FUNCT3 
FUNCT4 
FUNCT5 
FUNCT6 



Assume that 



contai ns 



Regi ster 8 

argument. 
Register 9 contains the 

table in bytes (00 00 
Register 10 contains the 

table in bytes (00 00 



the 



search 



width of 
00 04). 
length of 
00 18). 



the 
the 
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Register 11 contains the starting 

address of the table. 
Register 14 contains the return address 

to the main program. 



As the followi 
the argument 
sively compar 
the table, sta 
working backwa 
equali ty is 
function repla 
ter 8. If a 
zero replaces 
8. 

SEARCH 

NOTEQUAL 

NOTFOUND 

LOOP 



ng subr 
in regi 
ed with 
rting w 
rd to 
found, 
ces the 
n equal 
the ar 



outi ne 

ster 8 

the a 

i th ar 

argumen 

the c 

arguroe 

i ty is 

gument 



is executed, 

i s succes- 

rguments in 

gument 6 and 

t 1. If an 

orrespondi ng 

nt in regis- 

not found, 

in register 



LNR 

BXH 

SR 

BCR 

CH 

BC 

LH 

BCR 



9,9 

10, 9, LOOP 

8,8 

15,14 

8,0(10,11) 

7, NOTEQUAL 

8,2(10,11) 

15,14 



The first instruction (LNR) causes the 
value in register 9 to be made negative. 
After execution of this instruction, 
register 9 contains FF FF FF FC = 
-4(10} . Considering the case when no 
equality is found, the BXH instruction 
will be executed seven times. Each time 
BXH is executed, a value of -4 is added 
to register 10, thus reducing the value 
in register 10 by 4. The new value in 
register 10 is compared with the -4 
value in register 9. The branch is 
taken each time until the value in 
register 10 is -4. Then the branch is 



not taken, 
regi ster 8 



and the 

to zero. 



SR instruction sets 



BRANCH ON INDEX LOW OR EQUAL (BXLE) 



The BRANCH ON INDEX LOW 
instruction performs the same 
as BRANCH ON INDEX HIGH, ex 
branching occurs when the sum 
than or equal to (instead 
than) the compare value, 
instruction which increments 
an index value in a program 
is useful at the end of the lo 
at the beginning. The 
assembler-language routines 
loops with BXLE. 



BXLE Example 1 



OR EQUAL 

operati on 

cept that 

is lower 

of higher 

As the 

and tests 

loop, BXLE 

op and BXH 

followi ng 

i llustrate 



Assume that a group of ten 32-bit signed 
binary integers are stored at consec- 
utive locations, starting at location 
GROUP. The integers are to be added 
together, and the sum is to be stored at 
location SUM. 



SR 7,7 
LA 8,4 
LA 9,39 
LOOP A 5,0(7,6) 
BXLE 7,8, LOOP 
ST 5, SUM 



Set index to zero 
Load increment 4 
Load compare value 
Add integer to sum 
Test end of loop 
Store sum 



The two-instruction loop contains an ADD 
(A) instruction which adds each integer 
to the contents of general register 5. 
The ADD instruction uses the contents of 
general register 7 as an index value to 
modify the starting address obtained 
from register 6. Next, BXLE increments 
the index value by 4, the increment 

into register 8, and 

the compare value in 

odd register of this 

The compare value was 



previously loaded 
compares it with 
register 9, the 
even-odd pair 



SR 

LA 



5,5 

6, GROUP 



Set sum to zero 
Load first address 



previously set to 39, which is one less 
than the number of bytes in the data 
area; this is also the address, relative 
to the starting address, of the right- 
most byte of the last integer to be 
added. When the last integer has been 
added, BXLE increments the index value 
to the next relative address (40), which 
i s found to be greater than the compare 
value (39) so that no branching takes 
place. 



BXLE Example 2 



The technique illustrated in Example 1 
is restricted to loops containing 
instructions in the RX instruction 
format. That format allows both a base 
register and an index register to be 
specified (double indexing). 

For instructions in other formats, where 
an index register cannot be specified, 
the previous technique may be modified 
by having the address itself serve as 
the index value in a BXLE instruction 
and by using as the compare value the 
address of the last byte rather than its 
relative address. The base register 
then provides the address directly at 
each iteration of the loop, and it is 
not necessary to specify a second regis- 
ter to hold the index value (single 
i ndexing) . 

In the following example, an AND (NI) 
instruction in the SI instruction format 
sets to zero the rightmost bit of each 
of the same group of integers as in 
Example 1, thus making all of them even. 
The I 2 field of the NI instruction 
contains the byte X'FE', which consists 
of seven ones and a zero. That byte is 
ANDed into byte 3, the rightmost byte, 
of each of the integers in turn. 



LOOP 



LA 
LA 
LA 
NI 
BXLE 



6, GROUP 
8,4 

9,GR0UP+39 
3(6),X f FE» 
6,8, LOOP 



Load first address 
Load increment 4 
Load compare value 
AND immediate 
Test end of loop 
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The technique shown in Example 
not work* however* on a system 
370-XA mode when it is in the 
addressing mode and the data is 
at the rightmost end of a 31-bit 
space. In this case* the 
would be set to 2 31 -1, 



2 does 

in the 

31-bit 

located 

address 

compare value 

which is the 



largest possible 32 
value. The reason 
not work i s that 
instructions treat 
32-bit signed binary 
address in general 
the value 2 31 -4, BXLE 



bit signed binary 
the technique does 
the BXLE and BXH 
their operands as 
integers. When the 
register 6 reaches 
increments it to a 
rath- 



-?31 



value that is interpreted as 
er than 2 31 , and the comparison remains 
low* which causes looping to continue 
indef ini tely. 

This situation can be avoided by not 
allowing data areas to extend to the 
rightmost location in a 31-bit address 
space or by using other techniques* 
these may include double indexing when 
possible* as in Example 1* or starting 
at the end and stepping downward through 
the data area with a negative increment. 



COMPARE HALFWORD (CH) 



The COMPARE HALFWORD instruction 
compares a 16-bit signed binary integer 
in storage with the contents of a regis- 
ter. For example* assume that: 

Register 4 contains FF FF 80 00 = 

-32,768U0>. 
Register 13 contains 00 01 60 50. 
Storage locations 16080-16081 contain 

8000 = -32,768U0J. 

When the instruction: 



Machine Format 
Op Code Ri X 2 



49 


4 





D 


030 



Assembler Format 

Op Code R t ,D 2 (X 2 >B 2 ) 



CH 



4,X'30 f (0,13) 



is executed* the contents of locations 
16080-16081 are fetched, expanded to 32 
bits (the sign bit is propagated to the 
left), and compared with the contents of 
register 4. Because the two numbers are 
equal* condition code is set. 



COMPARE LOGICAL (CL, CLC* CLI, CLR) 



The COMPARE LOGICAL instruction differs 
from the si gned-bi nary comparison 
instructions (C, CH, CR) in that all 
quantities are handled as unsigned bina- 
ry integers or as unstructured data. 



CLC Example 



The COMPARE LOGICAL (CLC) instruction 
can be used to perform the byte-by-byte 
comparison of storage fields up to 256 
bytes in length. For example* assume 
that the following two fields of data 
are in storage: 



Field 1 
1886 



1891 



Dl 


D6 


C8 


D5 


E2 


D6 


D5 


6B 


CI 


4B 


... 
C2 




4B 



Field 2 
1900 



190B 



Dl 


D6 


C8 


D5 


E2 


D6 


D5 


6B 


CI 


4B 


C3 


4B 



Also assume: 

Register 9 contains 00 00 18 80. 
Register 7 contains 00 00 19 00. 

Execution of the instruction: 



Machine Format 
Op Code L Bi 



D, 



D5 


0B 


9 


006 


7 


000 



Assembler Format 

Op Code D t (L*Bi )*D 2 (B 3 ) 



CLC 



6(12, 9), 0(7) 



sets condition code 1, indicating that 
the contents of field 1 are lower in 
value than the contents of field 2. 

Because the collating sequence of the 
EBCDIC code is determined simply by a 
logical comparison of the bits in the 
code, the CLC instruction can be used to 
collate EBCDIC-coded fields. For exam- 
ple* in EBCDIC* the above two data 
fields are: 

Field 1: JOHNSON, A. B. 
Field 2: JOHNSON, A. C. 

Condition code 1 indicates that 
JOHNSON, A. B. should precede JOHNSON, A. C. 
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for the fields to be in alphabetic 
sequence. 



CLI Example 



executed; the contents of register 4 
Mould have been interpreted as +1 and 
the contents of register 7 as -1. Thus* 
the first operand Mould have been 
higher* so that condition code 2 would 
have been set. 



The COMPARE LOGICAL (CLI) instruction 
compares a byte from the instruction 
stream with a byte from storage. For 
example* assume that: 

Register 10 contains 00 00 17 00. 
Storage location 1703 contains 7E. 

Execution of the instruction: 



Machine Format 
Op Code I a B, 



D, 



95 


AF 


A 


003 



Assembler Format 
Op Code D t (Bi ),I 8 



CLI 



3(10)*X'AF» 



sets condition code 1* indicating that 
the first operand (the quantity in main 
storage) is lower than the second (imme- 
diate) operand. 



CLR Example 



COMPARE LOGICAL CHARACTERS UNDER MASK 
(CLM) 



The COMPARE LOGICAL CHARACTERS UNDER 
MASK (CLM) instruction provides a means 
of comparing bytes selected from a 
general register to a contiguous field 
of bytes in storage. The M 3 field of 
the CLM instruction is a four-bit mask 
that selects zero to four bytes from a 
general register* each mask bit corre- 
sponding* left to right* to a register 
byte. In the comparison* the register 
bytes corresponding to ones in the mask 
are treated as a contiguous field. The 
operation proceeds left to right. For 
example* assume that: 

Storage locations 10200-10202 contain 

F0 BC 7B. 
Register 12 contains 00 01 00 00. 
Register 6 contains F0 BC 5C 7B. 

Execution of the instruction: 



Machine Format 
Op Code R t 



B a D a 



BD 


6 


D 


C 


200 



Assume that: 

Register 4 contains 00 00 00 01 = 1. 
Register 7 contains FF FF FF FF 
2 32 - 1. 

Execution of the instruction: 



Machine Format 
Op Code R t R a 



15 


4 


7 



Assembler Format 
Op Code Ri *R a 



Assembler Format 

Op Code R t *M 3 *D a (B a ) 



CLM 



6,B'1101',X'200'(12) 



causes the following comparison: 

Register 6: F0 BC 5C 7B 
Mask M 3 : 1 1 1 



F0 



BC 

• 




~* 


'B 










1 




F0 


BC 


7B 



CLR 



4*7 



Storage 
locati ons 
10200-10202: 



Because the selected bytes are equal* 
condition code is set. 



sets condition code 1. Condition code 1 
indicates that the first operand is 
lower than the second. 

If* instead* the si gned-bi nary compar- 
ison instruction COMPARE (CR) had been 



COMPARE LOGICAL LONG (CLCL) 



The COMPARE LOGICAL LONG (CLCL) instruc- 
tion is used to compare two operands in 
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storage^ byte by byte. Each operand can 
be of any length. Two even-odd pairs of 
general registers (four registers in 
all) are used to locate the operands and 
to control the execution of the CLCL 
instruction, as illustrated in the 
following diagram. The first register 
of each pair must be an even register, 
and it contains the storage address of 
an operand. The odd register of each 
pair contains the length of the operand 
it covers, and the leftmost byte of the 
second-operand odd register contains a 
padding byte which is used to extend the 
shorter operand, if any, to the same 
length as the longer operand. 



The setup instructions are: 



The following 
of registers: 



illustrates the assignment 



Ri 
(even) 

( 


//////// 


First-Operand Address 


) 8 31 


R,+l 
(odd) 

( 


//////// 


Fi rst-Operand Length 


) 8 31 


R* 
(even) 

( 


//////// 


Second-Operand Address 


) 8 31 


R a + 1 


Pad Byte 


Second-Operand Length 



8 



31 



Since the CLCL instruction may be inter- 
rupted during execution, the interrupt- 
ing program must preserve the contents 
of the four registers for use when the 
instruction is resumed. 

The following instructions set up two 
register pairs to control a text-string 
comparison. For example, assume: 

Operand 1 

Address: 20800(16} 
Length: 100(10} 

Operand 2 

Address: 20A00(16} 
Length: 132(10} 

Padding Byte 

Address: 20003(16} 
Length: 1 
Value: 40(16} 

Register 12 contains 00 02 00 00. 



LA 4,X*800 , (12) 



LA 5,100 



LA 8,X , A00 , (12) 



LA 9,132 



ICM 9,B , 1000 , ,3(12) 



Set register 4 to 
start of first 
operand 

Set register 5 to 
length of first 
operand 

Set register 8 to 
start of second 
operand 

Set register 9 to 
length of second 
operand 

Insert padding byte 
in leftmost byte 
position of regis- 
ter 9 



Register pair 4,5 defines the first 
operand. Bits 8-31 of register 4 
contain the storage address of the start 
of an EBCDIC text string, and bits 8-31 
of register 5 contain the length of the 
string, in this case 100 bytes. 



Regi s 

opera 

conta 

secon 

9 con 

opera 

0-7 

blank 

short 

paddi 

and, 

wi th 

opera 



ter pair 8,9 defines the second 
nd, with bits 8-31 of register 8 
ining the starting location of the 
d operand and bits 8-31 of register 
taining the length of the second 
case 132 bytes. Bits 
9 contain an EBCDIC 
(X'40 f ) to pad the 
In this example, the 
used in the first oper- 
100th 



nd, in this 
of register 

character 
er operand, 
ng byte i s 
after the 



byte, to compare 



the 
nd. 



remaining bytes in the second 



With the register pairs thus set up, 
format of the CLCL instruction is: 



Machine Format 
Op Code R t R 2 



the 



OF 


4 


8 



Assembler Format 
Op Code Ri ,R 2 



CLCL 



4,8 



When this instruction is executed, the 
comparison starts at the left end of 
each operand and proceeds to the right. 
The operation ends as soon as an 
inequality is detected or the end of the 
longer operand is reached. 

If this CLCL instruction is interrupted 
after 60 bytes have compared equal, the 
operand lengths in registers 5 and 9 
will have been decremented to 40 and 72, 
respectively. The operand addresses in 
registers 4 and 8 will have been incre- 
mented to X»2083C f and X'20A3C; the 
leftmost byte of registers 4 and 8 will 
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have been set to zero. The padding byte 
X»40 f remains in register 9. When the 
CLCL instruction is reexecuted with 
these register contents* the comparison 
resumes at the point of interruption. 

Now* assume that the instruction is 
interrupted after 110 bytes. That is* 
the first 100 bytes of the second oper- 
and have compared equal to the first 
operand* and the next 10 bytes of the 
second operand have compared equal to 
the padding byte (blank). The residual 
operand lengths in registers 5 and 9 are 
and 22, respectively* and the operand 
addresses in registers 4 and 8 are 
X*20864' (the value when the first oper- 
and was exhausted) and X , 20A6E" (the 
current value for the second operand). 

When the comparison ends* the condition 
code is set to 0* 1* or 2* depending on 
whether the first operand is equal to* 
less than* or greater than the second 
operand* respectively. 

When the operands are unequal* the 
addresses in registers 4 and 8 indicate 
the bytes that caused the mismatch. 



CONVERT TO BINARY (CVB) 



The CONVERT TO BINARY instruction 
converts an eight-byte* packed-decimal 
number into a signed binary integer and 
loads the result into a general 
register. After the conversion opera- 
tion is completed* the number is in the 
proper form for use as an operand in 
signed binary arithmetic. For example* 
assume: 

Storage locations 7608-760F contain a 
decimal number in the packed 
format: 00 00 00 00 00 25 59 4C 
(+25,594). 

The contents of register 7 are not 
si gni f i cant. 

Register 13 contains 00 00 76 00. 

The format of the conversion instruction 
i s: 



Machine Format 
Op Code R, X 2 



4F 


7 





D 


008 



Assembler Format 

Op Code R,,D 2 (X 2 ,B 2 ) 



After the instruction is executed* 
register 7 contains 00 00 63 FA. 



CONVERT TO DECIMAL (CVD) 



The CONVERT TO DECIMAL instruction is 
the opposite of the CONVERT TO BINARY 
instruction. CVD converts a signed 
binary integer in a register to packed 
decimal and stores the eight-byte 
result. For example* assume: 

Register 1 contains the signed binary 

integer: 00 00 OF OF. 
Register 13 contains 00 00 76 00. 

The format of the instruction is: 



Machine Format 
Op Code Ri X a 



4E 


1 





D 


008 



Assembler Format 

Op Code Ri ,D 3 (X 2 ,B 3 ) 



CVD 



1,8(0,13) 



CVB 



7,8(0,13) 



After the instruction is executed, stor- 
age locations 7608-760F contain 00 00 00 
00 00 03 85 5C (+3855). 

The plus sign generated is the preferred 
plus sign, 1100(2} . 



DIVIDE (D, DR) 



The DIVIDE instruction divides the divi- 
dend in an even-odd register pair by the 
divisor in a register or in storage. 
Since the instruction assumes the divi- 
dend to be 64 bits long, it is important 
first to extend a 32-bit dividend on the 
left with bits equal to the sign bit. 
For example, assume that: 

Storage locations 3550-3553 contain 00 

00 08 DE = 2270(10} (the 

dividend). 
Storage locations 3554-3557 contain 00 

00 00 32 = 50(10} (the divisor). 
The initial contents of registers 6 and 

7 are not significant. 
Register 8 contains 00 00 35 50. 

The following assembler-language state- 
ments load the registers properly and 
perform the divide operation: 
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Statement 


Comments 


L 6,0(0,8) 


Places 00 00 08 DE into 




register 6. 


SRDA 6,32(0) 


Shifts 00 00 08 DE into 




register 7. Register 




6 is filled with zeros 




(sign bits). 


D 6,4(0,8) 


Performs the division. 



The machine format of the above DIVIDE 
instruction is: 



Machine Format 
Op Code R, X 9 



5D 


6 





8 


004 



After the instructions 
executed: 



listed above sr& 



Register 6 contains 00 00 00 14 = 

20(10} = the remainder. 

Register 7 contains 00 00 00 2D = 

45(10) = the quotient. 

Note that if the dividend had not been 
first placed in register 6 and shifted 
into register 7, register 6 might not 
have been filled with the proper 
dividend-sign bits (zeros in this exam- 
ple), and the DIVIDE instruction might 
not have given the expected results. 



EXCLUSIVE OR (X, XC, XI, XR) 



When the Boolean operator EXCLUSIVE OR 
is applied to two bits, the result is 
one when either, but not both, of the 
two bits is one; otherwise, the result 
is zero. When two bytes are EXCLUSIVE 
ORed, each pair of bits is handled sepa- 
rately; there is no connection from one 
bit position to another. The following 
is an example of the EXCLUSIVE OR of two 
bytes: 



First-operand byte: 
Second-operand byte: 



0011 0101(2} 
0101 1100(2} 



359 




35B 


Field 1 


00 


17 


90 


360 362 


Field 2 


00 


14 


01 



Execution of the instruction (assume 
that register 7 contains 00 00 03 58): 



Machine Format 
Op Code L B t D, B t D 2 



D7 


02 


7 


001 


7 


008 



Assembler Format 

Op Code D« (L,B, ),D 3 (B a ) 



XC 



1(3, 7), 8(7) 



Field 1 is EXCLUSIVE ORed with field 2 
as follows: 

Field 1: 00000000 00010111 10010000(2} 

= 00 17 90(16} 
Field 2: 00000000 00010100 00000001(2} 

= 00 14 01(16} 

Result: 00000000 00000011 10010001(2} 
= 00 03 91(16} 

The result replaces the former contents 
of field 1. Condition code 1 is set to 
indicate a nonzero result. 

Now, execution of the instruction: 



Machine Format 
Op Code L B, 



D, 



D7 


02 


7 


008 


7 


001 



Assembler Format 

Op Code D, (L,B, ),D 2 (B 2 ) 



Result byte: 



0110 1001(2} 



XC 



8(3,7), 1(7) 



XC Example 



The EXCLUSIVE OR (XC) instruction can be 
used to exchange the contents of two 
areas in storage without the use of an 
intermediate storage area. For example, 
assume two three-byte fields in storage: 



produces the following result: 

Field 1: 00000000 00000011 10010001(2} 

= 00 03 91(16} 
Field 2: 00000000 00010100 00000001(2} 

= 00 14 01(16} 

Result: 00000000 00010111 10010000(2} 
= 00 17 90(16} 

The result of this operation replaces 
the former contents of field 2. Field 2 
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now contains the original value of field 
1. Condition code 1 is set to indicate 
a nonzero result. 

Lastly, execution of the instruction: 



Location 8082: 0110 1001(2} 
Immediate byte: 1000 0001(2} 



Machine Format 
Op Code L B t 



D, 



D7 


02 


7 


001 


7 


008 



Assembler Format 

Op Code D, (L,Bi ),D 2 (B a ) 



XC 



1(3, 7), 8(7) 



produces the following result: 

Field 1: 00000000 00000011 10010001(2} 

= 00 03 91(16} 
Field 2: 00000000 00010111 10010000(2} 

= 00 17 90(16} 

Result: 00000000 00010100 00000001(2} 
= 00 14 01(16} 

The result of this operation replaces 

the former contents of field 1. Field 1 

now contains the original value of field 

2. Condition code 1 is set to indicate 
a nonzero result. 



XI Example 



A frequent use of the EXCLUSIVE OR (XI) 
instruction is to invert a bit (change a 
zero bit to a one or a one bit to a 
zero). For example, assume that storage 
location 8082 contains 0110 1001(2}. To 
invert the leftmost and rightmost bits 
without affecting any of the other bits, 
the following instruction can be used 
(assume that register 9 contains 00 00 
80 80): 



Result: 



1110 1000(2} 



The resulting byte is stored back in 
location 8082. Condition code 1 is set 
to indicate a nonzero result. 

Notes : 

1. With the XC instruction, fields up 
to 256 bytes in length can be 
exchanged. 

2. With the XR instruction, the 
contents of two registers can be 
exchanged. 

3. Because the X instruction operates 
storage to register only, an 
exchange cannot be made solely by 
the use of X. 

4. A field EXCLUSIVE ORed with itself 
is cleared to zeros. 

5. For additional examples of the use 
of EXCLUSIVE OR, see the section 
"Floating-Point-Number Conversi on" 
later in this appendix. 



EXECUTE (EX) 



The EXECUTE instruction causes one 
target i nstructi on in main storage to be 
executed out of sequence without actual- 
ly branching to the target instruction. 
Unless the R, field of the EXECUTE 
instruction is zero, bits 8-15 of the 
target instruction are ORed with bits 
24-31 of the Ri register before the 
target instruction is executed. Thus, 
EXECUTE may be used to supply the length 
field for an SS instruction without 
modifying the SS instruction in storage. 
For example, assume that a MOVE (MVC) 
instruction is the target that is 
located at address 3820, with a format 
as follows: 



Machine Format 
Op Code I 2 Bi 



D, 



97 


81 


9 


002 



Machine Format 
Op Code L Bi 



Di 



D2 


00 


C 


003 


D 


000 



Assembler Format 
Op Code D, (B t ),I 2 



XI 



2(9),X f 81 f 



Assembler Format 

Op Code Di (L,B, ),D 2 (B a ) 



MVC 



3(1, 12), 0(13) 



When the instruction is executed, the 
byte in storage is EXCLUSIVE ORed with 
the immediate byte (the I 2 field of the 
instruction) : 



where register 12 contains 00 00 89 13 
and register 13 contains 00 00 90 A0. 



A-18 370-XA Principles of Operation 



Further assume that at storage address 
5000, the following EXECUTE instruction 
is located: 



Machine Format 
Op Code R t X 2 



44 


1 





A 


000 



Assembler Format 

Op Code R t ,D 2 (X 2 ,B 2 ) 



EX 



1,0(0,10) 



where register 10 contains 00 00 38 20 
and register 1 contains 00 OF F0 03. 

When the instruction at 5000 is 
executed, the rightmost byte of register 
1 is ORed with the second byte of the 
target instruction: 



Instruction byte: 
Register byte: 



0000 0000(2} = 00 
0000 0011(2} = 03 



Result: 



0000 0011(2} = 03 



causing the instruction at 3820 to be 
executed as if it originally wc»re: 



condition code to indicate the value of 
the inserted field. 

For example, if it is desired to insert 
a three-byte address from FIELDA into 
register 5 and leave the leftmost byte 
of the register unchanged, assume: 



Machine Format 



Op Code 


Rt 


M 3 


s 2 


BF 


5 


7 


X X X X 



Assembler Format 
Op Code Ri ,M 3 ,S a 



I CM 



5, B f 0111 f , FIELDA 



FIELDA: 

Register 5 (before): 
Register 5 (after): 
Condition code (after) 



As another example: 



FE DC BA 
12 34 56 78 
12 FE DC BA 
1 (leftmost 
bit of 
inserted 
f i eld i s 
one) 



Machine Format 
Op Code L B t 



D, 



D2 


03 


C 


003 


D 


000 



Machine Format 
Op Code R, M 3 



BF 


6 


9 


X X X X 



Assembler Format 

Op Code D t (L,B 1 ),D 2 (B 2 ) 



MVC 



3(4, 12), 0(13) 



Assembler Format 
Op Code R t ,M 3 ,S 2 



I CM 



6,B'1001',FIELDB 



However, after execution: 

Register 1 is unchanged. 

The instruction at 3820 is unchanged. 

The contents of the four bytes starting 

at location 90A0 have been moved to 

the four bytes starting at location 

8916. 
The CPU next executes the instruction 

at address 5004 (PSW bits 40-63 

contain 00 50 04). 



INSERT CHARACTERS UNDER MASK (ICM) 



The INSERT CHARACTERS UNDER MASK (ICM) 
instruction may be used to replace all 
or selected bytes in a general register 
with bytes from storage and to set the 



FIELDB: 12 

Register 6 (before): 00 

Register 6 (after): 12 

Condition code (after): 2 



When the ma 
ICM instruct 
as LOAD (L) 
capabi li ty o 
ed), except 
condi ti on 
setting is u 
(condition c 
(condition c 



34 

00 00 00 
00 00 34 
( inserted 
field is 
nonzero 
with left- 
most zero 
bit) 



sk field contains 1111, the 
ion produces the same result 
(provided that the indexing 
f the RX format i s not need- 
that ICM also sets the 
code. The condition-code 
seful when an all-zero field 
ode 0) or a leftmost one bit 
ode 1) is used as a flag. 



Appendix A. Number Representation and Instruction-Use Examples A-19 



LOAD (L, LR) 



The LOAD instruction takes four bytes 
from storage or from a general register 
and place them unchanged into a general 
register. For example, assume that the 
four bytes starting with location 21003 
are to be loaded into register 10. 
Ini t ially : 

Register 5 contains 00 02 00 00. 
Register 6 contains 00 00 10 03. 
The contents of register 10 are not 

si gni f i cant. 
Storage locations 21003-21006 contain 

00 00 AB CD. 



To load register 10, the 
instruction can be used: 



Machine Format 
Op Code R, X a 



RX form of the 



58 


A 


5 


6 


000 



Assembler Format 
Op Code R, ,D 2 (X 2 ,B 2 ) 
L 10,0(5,6) 



After the instruction is executed, 
register 10 contains 00 00 AB CD. 



LOAD ADDRESS (LA) 



The LOAD ADDRESS instruction provides a 
convenient way to place a nonnegative 
binary integer up to 4095(10} in a 
register without first defining a 
constant and then using it as an 
operand. For example, the following 
instruction places the number 2048(10} 
in register 1: 



Machine Format 
Op Code R, 



41 


1 








800 



Assembler Format 

Op Code R, ,D 2 (X 2 ,B 2 ) 



LA 



1,2048(0,0) 



The LOAD ADDRESS instruction can also be 
used to increment a register by an 



amount up to 4095(10} specified in the 
D 2 field. Depending on the addressing 
mode, only the rightmost 24 or 31 bits 
of the sum are retained, however. The 
leftmost bits of the 32-bit result are 
set to zeros. For example, assume that 
register 5 contains 00 12 34 56. 

The instruction: 



Machine Format 
Op Code R, X 2 



41 


5 





5 


00A 



Assembler Format 

Op Code R, ,D 2 (X 2 ,B 2 ) 



LA 



5,10(0,5) 



of 



adds 10 (decimal) to the contents 
register 5 as follows: 

Register 5 (old): 00 12 34 56 
D 2 field: 00 00 00 0A 

Register 5 (new): 00 12 34 60 



The register may be specified as either 
B a or X 2 . Thus, the instruction LA 
5,10(5,0) produces the same result. 

As the most general example, the 
instruction LA 6,10(5,4) forms the sum 
of three values: the contents of regis- 
ter 4, the contents of register 5, and a 
displacement of 10 and places the 24-bit 
or 31-bit sum with zeros appended on the 
left in register 6. 



LOAD HALFWORD (LH) 



The LOAD HALFWORD instruction places 
unchanged a halfword from storage into 
the right half of a register. The left 
half of the register is loaded with 
2eros or ones according to the sign 
(leftmost bit) of the halfword. 

For example, assume that the two bytes 
in storage locations 1803-1804 are to be 
loaded into register 6. Also assume: 

The contents of register 6 are not 

si gni f i cant. 
Register 14 contains 00 00 18 03. 
Locations 1803-1804 contain 00 20. 



The instruction 
register is: 



required to load the 
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Machine Format 
Op Code R, X 2 



D 2 



48 


6 





E 


000 



Assembler Format 

Op Code R, ,D 2 (X 2 ,B 2 ) 



LH 



6,0(0,14) 



After the instruction is executed, 
register 6 contains 00 00 00 20. If 
locations 1803-1804 had contained a 
negative number, for example, A7 B6, a 
minus sign would have been propagated to 
the left, giving FF FF A7 B6 as the 
final result in register 6. 



MOVE (MVC, MVI) 



2048 



2052 



Fl 


F2 


F3 


F4 


F5 


F6 


F7 


F8 


C9 


CA 


CB 



Field 
1 



Field 2 is unchanged. 

MVC can also be used to propagate a byte 
through a field by starting the first- 
operand field one byte location to the 
right of the second-operand field. For 
example, suppose that an area in storage 
starting with address 358 contains the 
following data: 



358 



360 



00 


Fl 


F2 


F3 


F4 


F5 


F6 


F7 


F8 



With the following MVC instruction, the 
zeros in location 358 can be propagated 
throughout the entire field (assume that 
register 11 contains 00 00 03 58): 



Machine Format 



MVC Example 



The MOVE (MVC) instruction can be used 

to move data from one storage location 
to another. For example, assume that 

the following two fields are in storage: 

2048 2052 
Field 
1 



Field 
2 



Also assume: 

Register 1 contains 00 00 20 48. 
Register 2 contains 00 00 38 40. 

With the following instruction, the 
first eight bytes of field 2 replace the 
first eight bytes of field 1: 



CI 


C2 


C3 


C4 


C5 


C6 


C7 


C8 


C9 


CA 


CB 


3840 384? 


* 


Fl 


F2 


F3 


F4 


F5 


F6 


F7 


F8 


F9 





Machine Format 
Op Code L Bi 



D, 



D2 


07 


1 


000 


2 


000 



Assembler Format 

Op Code D t (L,B t ),D 2 (B 2 ) 



MVC 



0(8,1), 0(2) 



After the instruction is executed, field 
1 becomes: 



Op Code 


L 


B, 


D, 


B 2 


D 2 


D2 


07 


B 


001 


B 


000 



Assembler Format 

Op Code Di (L,Bi ),D 2 (B 2 ) 



MVC 



1(8, 11), 0(11) 



Because MVC is executed as if one byte 
were processed at a time, the above 
instruction, in effect, takes the byte 
at address 358 and stores it at 359 (359 
now contains 00), takes the byte at 359 
and stores it at 35A, and so on, until 
the entire field is filled with zeros. 
Note that an MVI instruction could have 
been used originally to place the byte 
of zeros in location 358. 



Notes: 



Although the field occupying 
locations 358-360 contains nine 
bytes, the length 
assembler format is 
number of moves (one 
field length). 



coded in the 
equal to the 
less than the 



The order of operands is important 
even though only one field is 
involved. 



MVI Example 



The MOVE (MVI) instruction places one 
byte of information from the instruction 
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stream into storage. For example, the 
instruction: 



Machine Format 
Op Code I 2 Bt 



D, 



92 


5B 


1 


000 



Assembler Format 
Op Code Di (Bt ),I a 



MVI 



0(l),C f $ f 



may be used, in conjunction with the 
instruction EDIT AND MARK, to insert the 
EBCDIC code for a dollar symbol at the 
storage address contained in general 
register 1 (see also the example for 
EDIT AND MARK). 



MOVE INVERSE (MVCIN) 



The MOVE INVERSE (MVCIN) instruction can 
be used to move data from one storage 
location to another while reversing the 
order of the bytes within the field. 
For example, assume that the following 
two fields are in storage: 

2048 2052 

Field 
1 



Field 
2 



Also assume: 

Register 1 contains 00 00 20 48. 
Register 2 contains 00 00 38 40. 

With the following instruction, the 
first eight bytes of field 2 replace the 
first eight bytes of field 1: 



CI 


C2 


C3 


C4 


C5 


C6 


C7 


C8 


C9 


CA 


CB 


3840 384* 


\ 


Fl 


F2 


F3 


F4 


F5 


F6 


F7 


F8 


F9 





Machine Format 
Op Code L B, 



D, 



E8 


07 


1 


000 


2 


007 



Assembler Format 
Op Code D, (L,B, ),D 2 (B 3 ) 
MVCIN 0(8,1), 7(2) 



After the instruction is executed, field 
1 becomes: 



2048 



2052 



F8 


F7 


F6 


F5 


F4 


F3 


F2 


Fl 


C9 


CA 


CB 



Field 
1 



Field 2 is unchanged. 

Note : This example uses the same gener- 
al registers, storage locations, and 
original values as the first example for 
MVC. For MVCIN, the second-operand 
address must designate the rightmost 
byte of the field to be moved, in this 
case location 3847. This is accom- 
plished by means of the 7 in the D a 
field of the instruction. 



MOVE LONG (MVCL) 



The MOVE LONG (MVCL) instruction can be 
used for moving data in storage as in 
the first example of the MVC 
instruction, provided that the two oper- 
ands do not overlap. MVCL differs from 
MVC in that the address and length of 
each operand are specified in an even- 
odd pair of general registers. 
Consequently, MVCL can be used to move 
more than 256 bytes of data with one 
instruction. As an example, assume: 

Register 2 contains 00 0A 00 00. 

Register 3 contains 00 00 08 00. 

Register 8 contains 00 06 00 00. 

Register 9 contains 00 00 08 00. 

Execution of the instruction: 



Machine Format 
Op Code Ri R a 



0E 


8 


2 



Assembler Format 
Op Code Ri ,R 2 



MVCL 



8,2 



moves 2,048(10} bytes from locations 
A0000-A07FF to locations 60000-607FF. 
Bits 8-31 of registers 2 and 8 are 
incremented by 800(16}, and bits 0-7 of 
registers 2 and 8 are set to zeros. 
Bits 8-31 of registers 3 and 
decremented to zero. Condition 
is set to indicate that the 
lengths are equal. 



9 are 

code 

operand 



If register 3 had contained F0 00 04 00, 
only the 1,024(10} bytes from locations 
A0000-A03FF would have been moved to 
locations 60000-603FF. The remaining 
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locations 60400-607FF of the first oper- 
and would have been filled with 1*024 
copies of the padding byte X'FO*, as 
specified by the leftmost byte of regis- 
ter 3. Bits 8-31 of registers 2 and 8 
would have been incremented by 400(16}* 
and bits 0-7 of registers 2 and 8 set to 
zeros. Bits 8-31 of registers 3 and 9 
would still have been decremented to 
zero. Condition code 2 would have been 
set to indicate that the first operand 
was longer than the second. 

The technique for setting a field to 
zeros that is illustrated in the second 
example of MVC cannot be used with MVCL. 
If the regi sters were set up to attempt 
such an operation with MVCL* no data 
movement would take place and condition 
code 3 would indicate destructive ovei — 
lap. 

Instead* MVCL may be used to clear a 
storage area to zeros as follows. 
Assume regi ster 8 and 9 are set up as 
before. Register 3 contains only zeros* 
specifying zero length for the second 
operand and a zero padding byte. Regis- 
ter 2 is not used to access storage* and 
its contents are not significant. 
Executing the instruction MVCL 8*2 caus- 
es locations 60000-607FF to be filled 
with zeros. Bits 8-31 of register 8 are 
incremented by 800(16}, and bits 0-7 of 
registers 2 and 8 are set to zeros. 
Bits 8-31 of register 9 are decremented 
to zero* and condition code 2 is set to 
indicate that the first operand is larg- 
er than the second. 



MOVE NUMERICS (MVN) 



After the instruction: 



Two related instruct 
and MOVE ZONES, may 
data in the zoned 
separately on the 
(the numeric bits) a 
bits (the zone bits) 
are similar to MOVE 
MOVE NUMERICS move 
bits and MOVE ZONES 
bits. 



ions, MOVE 
be used with 

format to 
rightmost fo 
nd the leftm 

of each byt 

(MVC)* exc 
s only the 

moves only 



NUMERICS 

decimal 

operate 

ur bits 

ost four 

e. Both 

ept that 

numeri c 

the zone 



To illustrate the operation of the MOVE 
NUMERICS instruction* assume that the 
following two fields are in storages 



7090 



7093 



Field B 



Also assume: 



C6 


C7 


C8 


C9 




7041 


7046 


F0 


Fl 


F2 


F3 


F4 


F5 



Register 14 contains 00 00 70 90 
Register 15 contains 00 00 70 40 



Machine Format 
Op Code L Bi 



Di B 3 



Dl 


03 


F 


001 


E 


000 



Assembler Format 

Op Code Dt(L*Bi )*D 2 (B a ) 



MVN 



1(4, 15), 0(14) 



is executed, field B becomes: 
7041 7046 



F6 


F7 


F8 


F9 


F4 


F5 



The numeric bits of the bytes at 
locations 7090-7093 have been stored in 
the numeric bits of the bytes at 
locations 7041-7044. The contents of 
locations 7090-7093 and 7045-7046 are 
unchanged. 



MOVE WITH OFFSET (MVO) 



MOVE WITH OFFSET may be used to shift a 
packed-decimal number an odd number of 
digit positions or to concatenate a sign 
to an unsigned packed-decimal number. 

Assume that the three-byte unsigned 
packed-decimal number in storage 
locations 4500-4502 is to be moved to 
locations 5600-5603 and given the sign 
of the packed-decimal number ending at 
location 5603. Also assume: 

Register 12 contains 00 00 56 00. 
Register 15 contains 00 00 45 00. 
Storage locations 5600-5603 contain 77 

88 99 OC. 
Storage locations 4500-4502 contain 12 

34 56. 



After the instruction: 



Machine Format 
Op Code Li L a 



B, D, 



B 2 



Fl 


3 


2 


C 


000 


F 


000 



Assembler Format 

Op Code Di (L, *Bi ),D 2 (L2»B 2 ) 



MVO 



0(4*12), 0(3, 15) 
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is executed, the storage locations 
5600-5603 contain 01 23 45 6C. Note 
that the second operand i s extended on 
the left with one zero to fill out the 
first-operand field. 



Storage locations 3750-3753 contain 00 
00 00 83 = 131U0) = the 
multi pli er . 

The instruction required for performing 
the multiplication is: 



MOVE ZONES (MVZ) 



The MOVE ZONES instruction can operate 
on overlapping or nonoverlappi ng fields, 
as can the instructions MOVE (MVC) and 
MOVE NUMERICS. When operating on nono- 
verlapping fields, MOVE ZONES works like 
the MOVE NUMERICS instruction (see its 
example), except that MOVE ZONES moves 
only the zone bits of each byte. To 
illustrate the use of MOVE ZONES with 
overlapping fields, assume that the 
following data field is in storage: 



800 



805 



Fl 


C2 


F3 


C4 


F5 


C6 



Also assume that register 15 contains 00 
00 08 00. The instruction: 



Machine Format 
Op Code L B, 



D, 



D3 


04 


F 


001 


F 


000 



Machine Format 
Op Code R t X 2 



B a 



5C 


4 


B 


C 


150 



Assembler Format 

Op Code Ri ,D 2 (X 2 ,B 2 ) 



M 



4,X , 150 T (11,12) 



After the instruction is executed, the 
product is in the register pair 4 and 5: 

Register 4 contains 00 00 00 00. 
Register 5 contains 00 00 4E CE = 

20,174(10}. 
Storage locations 3750-3753 are 

unchanged. 

The RR format of the instruction can be 
used to square the number in a register. 
Assume that register 7 contains 00 01 00 
05. The contents of register 6 are not 
significant. The instruction: 



Assembler Format 

Op Code D, (L,B, ),D 2 (B 2 ) 



MVZ 



1(5, 15), 0(15) 



Machine Format 
Op Code R f R 2 



1C 


6 


7 



propagates the zone bits from the byte 
at address 800 through the entire field, 
so that the field becomes: 



800 



805 



Fl 


F2 


F3 


F4 


F5 


F6 



MULTIPLY (M, MR) 



Assembler Format 
Op Code Ri ,R 2 



MR 



6,7 



multiplies the number in register 7 by 
itself and places the result in the pair 
of registers 6 and 7: 

Register 6 contains 00 00 00 01. 
Register 7 contains 00 0A 00 19. 



Assume that a number in register 5 i s to 

be multiplied by the contents of a 

foui — byte field at address 3750. 
Ini tially : 

The contents of register 4 are not 

si gni f i cant- 
Register 5 contains 00 00 00 9A = 

154(10} = the multiplicand. 
Register 11 contains 00 00 06 00. 
Register 12 contains 00 00 30 00. 



MULTIPLY HALFWORD (MH) 



The MULTIPLY HALFWORD instruction is 
used to multiply the contents of a 
register by a two-byte field in storage. 
For example, assume that: 



Register 11 contains 00 00 00 

=21(10} = the multiplicand. 
Register 14 contains 00 00 01 00. 



15 
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Register 15 contains 00 00 20 00. 
Storage locations 2102-2103 contain FF 
D9 = -39(10} = the multiplier. 

The instruction: 



Machine Format 
Op Code I 2 B t Dt 



96 


01 


8 


001 



Machine Format 
Op Code R t X 3 



4C 


B 


E 


F 


002 



Assembler Format 
Op Code D { (B, ),I a 



01 



1C8),X'01 V 



Assembler Format 

Op Code R 1 ,D 2 (X 3 ,B 2 ) 



OR MH 



11,2(14,15) 



multiplies the two numbers. The 
product, FF FF FC CD = -819(10}, 
replaces the original contents of regis- 
ter 11. 

Only the rightmost 32 bits of a product 
are stored in a register; any signif- 
icant bits on the left are lost. No 
program interruption occurs on overflow. 



When this instruction is executed, the 
byte in storage is ORed with the immedi- 
ate byte (the I a field of the instruc- 
ti on) : 



Location 4891: 
Immediate byte: 



0100 0010(2} 
0000 0001(2} 



Result: 



0100 0011(2} 



The resulting byte with bit 7 set to one 
is stored back in location 4891. Condi- 
tion code 1 is set. 



PACK (PACK) 



OR (0, OC, 01, OR) 



When the Boolean operator OR is applied 
to two bits, the result is one when 
either bit is one; otherwise, the result 
is zero. When two bytes are ORed, each 
pair of bits is handled separately; 
there is no connection from one bit 
position to another. The following is 
an example of ORing two bytes: 



First-operand byte: 
Second-operand byte: 



0011 0101(2} 
0101 1100(2} 



Result byte: 



01 Example 



0111 1101(2} 



Assume that storage locations 1000-1003 
contain the following zoned-decimal 
number that is to be converted to a 
packed-decimal number and left in the 
same location: 



1000 



1003 



Zoned number Fl F2 F3 C4 



Also assume that register 12 contains 00 
.00 10 00. After the instruction: 



Machine Format 
Op Code L, 



B, D, 



F2 


3 


3 


C 


000 


C 


000 



A frequent use of the OR instruction is 
to set a particular bit to one. For 
example, assume that storage location 
4891 contains 0100 0010(2}. To set the 
rightmost bit of this byte to one with- 
out affecting the other bits, the 
following instruction can be used 
(assume that register 8 contains 00 00 
48 90): 



Assembler Format 

Op Code Di (Li ,B t ),D 2 (L S ,B 2 ) 



PACK 



0(4, 12), 0(4, 12) 



is executed, the result in locations 
1000-1003 is in the packed-decimal 
format: 



1000 



1003 



Packed number 00 01 23 4C 
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\ 



Notes: 



This example illustrates the opera- 
tion of PACK when the first- and 
second-operand fields overlap 
completely. 

During the operation* the second 
operand was extended on the left 
with zeros. 



instruction performs an algebraic left 
shift of a 32-bit signed binary integer. 

For example, if the contents of register 
2 are: 

00 7F 0A 72 = 00000000 01111111 00001010 
01110010(2} 

The instruction: 



SHIFT LEFT DOUBLE (SLDA) 



The SHIFT LEFT DOUBLE instruction shifts 
the 63 numeric bits of an even-odd 
register pair to the left, leaving the 
sign bit unchanged. Thus, the instruc- 
tion performs an algebraic left shift of 
a 64-bit signed binary integer. 

For example, if the contents of regis- 
ters 2 and 3 are: 

00 7F 0A 72 FE DC BA 98 = 
00000000 01111111 00001010 0111C010 
11111110 11011100 10111010 10011000{2) 

The instruction: 



Machine Format 
Op Code Ri 



8F 


2 


//// 





01F 



Assembler Format 
Op Code Ri ,D 2 (B a ) 



Machine Format 
Op Code R, 



8B 


2 


//// 





008 



Assembler Format 
Op Code Ri ,D 2 (B 2 ) 



SLA 



2,8(0) 



SLDA 



2,31(0) 



results in register 2 being shifted left 
eight bit positions so that its new 
contents arei 

7F 0A 72 00 = 01111111 00001010 01110010 
00000000(2} 

Condition code 2 is set to indicate that 
the result is greater than zero. 

If a left shift of nine places had been 
specified, a significant bit would have 
been shifted out of bit position 1. 
Condition code 3 would have been set to 
indicate this overflow and, if the 
fixed-point-overflow mask bit in the PSW 
were one, a fixed-point overflow inter- 
ruption would have occurred. 



results in registers 2 and 3 both being 
left-shifted 31 bit positions, so that 
their new contents are: 

7F 6E 5D 4C 00 00 00 00 = 
01111111 01101110 01011101 01001100 
00000000 00000000 00000000 00000000(2} 

Because significant bits are shifted out 
of bit position 1 of register 2, over- 
flow is indicated by setting condition 
code 3, and, if the fixed-point-overflow 
mask bit in the PSW is one, a fixed- 
point-overflow program interruption 
occurs. 



STORE CHARACTERS UNDER MASK (STCM) 



STORE CHARACTERS UNDER MASK (STCM) may 
be used to place selected bytes from a 
register into storage. For example, if 
it is desired to store a three-byte 
address from general register 8 into 
location FIELD3, assume: 



Machine Format 
Op Code Ri 



BE 


8 


7 


X X X X 



SHIFT LEFT SINGLE (SLA) 



The SHIFT LEFT SINGLE 
similar to SHIFT LEFT 
that it shifts only the 
of a single register. 



instruction is 
DOUBLE, except 
31 numeric bits 
Therefore, this 



Register Format 
Op Code Ri ,M 3 ,S 2 



STCM 



8,B f 0111',FIELD3 
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Register 8: 
FIELD3 (before): 
FIELD3 (after): 



12 34 56 78 

not significant 
34 56 78 



As another example: 



Locations 4058-405B contain 12 43 00 

62. 
Locations 405C-405F contain 73 26 12 

57. 



Machine Format 
Op Code Rt M 3 



BE 


9 


5 


X X X X 



Register Format 
Op Code R t ,M 3 ,S a 



STCM 



9,B , 0101',FIELD2 



Register 9: 01 23 45 67 
FIELD2 (before): not significant 
FIELD2 (after): 23 67 



TEST UNDER MASK (TM) 



The TEST UNDER MASK instruction examines 



selected bits of a byte and sets 
condition code accordingly, 
example^ assume that: 

Storage location 9999 contains FB . 
Register 7 contains 00 00 99 90. 

Assume the instruction to be: 

Machine Format 

Op Code I 2 B t D t 



91 


C3 


7 


009 



the 
For 



STORE MULTIPLE (STM) 



Assume that the contents of general 
registers 14, 15, 0, and 1 are to be 
stored in consecutive four-byte fields 
starting with location 4050 and that: 

Register 14 contains 00 00 25 63. 
Register 15 contains 00 01 27 36. 
Register contains 12 43 00 62. 
Register 1 contains 73 26 12 57. 
Register 6 contains 00 00 40 00. 
The initial contents of locations 
4050-405F are not significant. 

The STORE MULTIPLE instruction allows 
the use of just one instruction to store 
the contents of the four registers: 



Machine Format 
Op Code R t R 3 



90 


E 


1 


6 


050 



Assembler Format 

Op Code R,,R 3 ,D 2 (B 2 ) 



STM 



14,l,X'50 f (6) 



After the instruction is executed: 

Locations 4050-4053 contain 00 00 25 

63. 
Locations 4054-4057 contain 00 01 27 

36. 



Assembler Format 
Op Code D t (Bt ),I a 



TM 



9(7),B'11000011 T 



The instruction tests only those bits of 
the byte in storage for which the mask 
bits are ones: 

FB = 1111 1011(2} 
Mask = 1100 0011(2} 



Test = llxx xxll(2} 

Condition code 3 is set: all selected 
bits in the test result are ones. (The 
bits marked "x" are ignored.) 

If location 9999 had contained B9, the 
test would have been: 

B9 = 1011 1001(2} 
Mask = 1100 001112} 

Test = lOxx xxOK2} 

Condition code 1 is set: the selected 
bits are both zeros and ones. 

If location 9999 had contained 3C, the 
test would have been: 

3C = 0011 1100(2} 
Mask = 1100 0011(2} 

Test = OOxx xx00(2} 

Condition code is set: all selected 
bits are zeros. 

Note : Storage location 9999 remains 
unchanged. 
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TRANSLATE (TR) 



The TRANSLATE instruction can be used to 
translate data from any character code 
to any other desired code* provided that 
each character code consists of eight 
bits or fewer. An appropriate trans- 
lation table is required in storage. 

In the following example, EBCDIC code is 
translated to ASCII code. The first 
step is to create a 256-byte table in 
storage locations 1000-10FF. This table 
contains the characters of the ASCII 
code in the sequence of the binary 
representation of the EBCDIC code; that 
is, the ASCII representation of a char- 
acter is placed in storage at the 
starting address of the table plus the 
binary value of the EBCDIC represen- 
tation of the same character. 

For simplicity, the example shows only 
the part of the table containing the 
decimal digits: 



10F0 



10F9 



30 


31 


32 


33 


34 


35 


36 


37 


38 


39 



Assume that the four-byte field at stoi — 
age location 2100 contains the EBCDIC 
code for the digits 1984: 

Locations 2100-2103 contain Fl F9 F8 

F4. 

Register 12 contains 00 00 21 00. 

Register 15 contains 00 00 10 00. 

As the instruction: 

Machine Format 

Op Code L B t Di B a D 3 



is executed, the binary value of each 
EBCDIC byte is added to the starting 
address of the table, and the resulting 
address is used to fetch an ASCII byte: 

Table starting address: 1000 
First EBCDIC byte: Fl 

Address of ASCII byte: 10F1 

After execution of the instruction: 

Locations 2100-2103 contain 31 39 38 
34. 

Thus, the ASCII code for the digits 1984 
has replaced the EBCDIC code in the 
four-byte field at storage location 
2100. 



TRANSLATE AND TEST (TRT) 



The TRANSLATE AND T 
be used to scan a da 
ters with a special 
cate which charact 
meaning, a table sim 
for the TRANSLATE in 
except that zeros in 
characters without 
and nonzero values 
with a special meani 



EST instruction can 
ta field for charac- 
meaning. To indi- 
ers have a special 
ilar to the one used 
struction is set up, 
the table indicate 
any special meaning 
indicate characters 
ng. 



The figure "Translate-and-Test Table" 
that follows has been set up to distin- 
guish alphameric characters (A to Z and 
to 9) from blanks, certain special 
symbols, and all other characters which 
are considered invalid. EBCDIC coding 
is assumed. The 256-byte table is 
assumed stored at locations 2000-20FF. 



DC 


03 


C 


000 


F 


000 



Assembler Format 

Op Code D, (L,Bt ),D 2 (B 2 ) 



TR 



0(4, 12), 0(15) 
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3 4 5 6 7 8 



A B C D E F 



200. 
201_ 
202. 
203_ 
204. 
205_ 
206_ 
207. 
208. 
209. 
20A. 
20B. 
20C. 
20D. 
20E 



40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


04 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


08 


40 


OC 


10 


40 


14 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


1? 


1C 


20 


40 


40 


24 


28 


40 


40 


40 


40 


40 


40 


40 


40 


40 


2C 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


30 


34 


38 


3C 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


40 


00 


00 


00 


00 


00 


00 


00 


00 


00 


40 


40 


40 


40 


40 


40 


40 


00 


00 


00 


00 


00 


00 


00 


00 


00 


40 


40 


40 


40 


40 


40 


40 


40 


00 


00 


00 


00 


00 


00 


00 


00 


40 


40 


40 


40 


40 


40 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


40 


40 


40 


40 


40 


40 



Note ? If the character codes in the statement being 
translated occupy a range smaller than 00 through 
FF(16}, a table of fewer than 256 bytes can be used. 

Translate and Test Table 



The table entries for the alphameric 
characters in EBCDIC are 00; thus* the 
letter A (code CI) corresponds to byte 
location 20C1, which contains 00. 

The 15 special symbols have nonzero 
entries from 04(16} to 3C(16} in incre- 
ments of 4. Thus* the blank (code 40) 
has the entry 04(16} , the period (code 
4B) has the entry 08(16} , and so on. 

All other table positions have the entry 
40(16} to indicate an invalid character. 

The table entries are chosen so that 
they may be used to select one of a list 
of 16 words containing addresses of 
different routines to be entered for 
each special symbol or invalid character 
encountered during the scan. 

Assume that this list of 16 branch 
addresses is stored at locations 
3004-3043. 

Starting at storage location CA80, there 
is the following sequence of 21(10} 
EBCDIC characters, where "b" stands for 
a blank. 

Locations CA80-CA94: 



UNPKbPR0UT(9),W0RD(5) 

Also assume: 

Register 1 contains 00 00 CA 7F. 
Register 2 contains 00 00 30 00. 
Register 15 contains 00 00 20 00 

As the instruction: 

Machine Format 

Op Code L B t Di B 2 D 2 



DD 


14 


1 


001 


F 


000 



Assembler Format 

Op Code Di (L,B, ),D 2 (B 2 ) 



TRT 



1(21,1), 0(15) 



is executed, the value of the first 
source byte, the EBCDIC code for the 
letter U, is added to the starting 
address of the table to produce the 
address of the table entry to be exam- 
ined: 



Appendix A. Number Representation and Instruction-Use Examples A-29 



Table starting address 2000 
First source byte (U) E4 



Address of table entry 



20E4 



Because zeros Mere placed in storage 
location 20E4* no special action occurs. 
The operation continues with the second 
and subsequent source bytes until it 
reaches the blank in location CA84. 
When this symbol is reached* its value 
is added to the starting address of the 
table, as usual: 



Table starting address 
Source byte (blank) 



2000 
40 



Address of table entry 



2040 



Because location 2040 contains a nonzero 
value* the following actions occur: 

1. The address of the source byte* 
00CA84* is placed in the rightmost 
24 bits of register 1. 

2. The table entry* 04* is placed in 
the rightmost eight bits of regis- 
ter 2* which now contains 00 00 30 
04. 



Condition code 
completed) . 



1 is set (scan not 



The TRANSLATE AND TEST i 
be followed by instruction 
the routine at the addr 
location 3004* which corr 
blank character encountere 
When this routine is comp 
control may return to the 
TEST instruction to conti 
except that the length 
adjusted for the chara 
scanned. 



instruction may 
s to branch to 
ess found at 
esponds to the 
cl in the scan, 
leted* program 
TRANSLATE AND 
nue the scan* 
must first be 
cters already 



For this purpose, the TRANSLATE AND TEST 
may be executed by the use of an EXECUTE 
instruction* which supplies the length 
specification from a general register. 
In this way* a complete statement scan 
can be performed with a single TRANSLATE 
AND TEST instruction used repeatedly by 
means of EXECUTE* and without modifying 
any instructions in storage. In the 
example* after the first execution of 
TRANSLATE AND TEST, register 1 contains 
the address of the last source byte 
translated. It is then a simple matter 
to subtract this address from the 
address of the last source byte (CA94) 
to produce a length specification. This 
length minus one is placed in the regis- 
ter that is referenced as the Rl field 
of the EXECUTE instruction. (Note that 
the length code in the machine format is 
one less than the total number of bytes 
in the field.) The second-operand 
address of the EXECUTE instruction 
points to the TRANSLATE AND TEST 



instruction* which is the same as illus- 
trated above* except for the length (L) 
which is set to zero. 



UNPACK (UNPK) 

Assume that storage locations 2501-2502 
contain a signed* packed-decimal number 
that is to be unpacked and placed in 
storage locations 1000-1004. Also 
assume: 

Register 12 contains 00 00 10 00. 
Register 13 contains 00 00 25 00. 
Storage locations 2501-2502 contain 12 

3D. 
The initial contents of storage 

locations 1000-1004 are not signif- 

i cant . 

After the instruction: 
Machine Format 
Op Code L, L 2 B, D, B 9 D a 



F3 


4 


1 


C 


000 


D 


001 



Assembler Format 

Op Code D, (Li *B t )*D 3 (L 2 >B 3 ) 



UNPK 



0(5*12), 1(2*13) 



is executed* the storage locations 
1000-1004 contain F0 F0 Fl F2 D3. 



DECIMAL INSTRUCTIONS 



(See Chapter 8 for a complete descrip- 
tion of the decimal instructions.) 



ADD DECIMAL (AP) 



Assume that the signed* packed-decimal 
number at storage locations 500-503 is 
to be added to the signed* packed- 
decimal number at locations 2000-2002. 
Also assume: 

Register 12 contains 00 00 20 00. 
Register 13 contains 00 00 05 00. 
Storage locations 2000-2002 contain 38 

46 0D (a negative number). 
Storage locations 500-503 contain 01 12 

34 5C (a positive number). 

After the instruction: 
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Machine Format 
Op Code L t L a 



B, D, 



FA 


2 


3 


C 


000 


D 


000 



Assembler Format 

Op Code D t (Li >B t )>D 3 (L 2 >B 2 ) 



AP 



0(3>12), 0(4,13) 



is executed* the storage locations 

2000-2002 contain 73 88 5C; condition 

code 2 is set to indicate that the 

result is greater than zero. Note that: 

1. Because the two numbers had differ- 
ent signs* they were in effect 
subtracted. 

2. Although the second operand is 
longer than the first operand, no 
overflow interruption occurs 
because the result can be entirely 
contained within the first operand. 



COMPARE DECIMAL (CP) 

Assume that the signed* packed-decimal 
contents of storage locations 700-703 
are to be algebraically compared with 
the signed* packed-decimal contents of 
locations 500-502. Also assume: 

Register 12 contains 00 00 06 00. 
Register 13 contains 00 00 03 00. 
Storage locations 700-703 contain 17 25 

35 6D. 
Storage locations 500-502 contain 72 14 

2D. 

After the instruction: 
Machine Format 
Op Code L t L a B t Di B 3 D 2 



F9 


3 


2 


C 


100 


D 


200 



Assembler Format 

Op Code D t (L t ,B, ),D 2 (L 2 ,B 2 ) 

CP X'100'(4,12),X'200'(3,13) 

is executed* condition code lis set* 
indicating that the first operand (the 
contents of locations 700-703) is less 
than the second. 



DIVIDE DECIMAL (DP) 



Assume that the signed* packed-decimal 
number at storage locations 2000-2004 
(the dividend) is to be divided by the 
signed* packed-decimal number at 
locations 3000-3001 (the divisor). Also 
assume: 

Register 12 contains 00 00 20 00. 
Register 13 contains 00 00 30 00. 
Storage locations 2000-2004 contain 01 

23 45 67 8C. 
Storage locations 3000-3001 contain 32 

ID. 

After the instruction: 
Machine Format 



Op Code 


L, 


1-2 


B, 


D, 


B 2 


D a 


FD 


4 


1 


C 


000 


D 


000 



Assembler Format 

Op Code Di (L, ,B, ),D 2 (L 2 ,B 2 ) 



DP 



0(5*12), 0(2*13) 



is executed, the dividend is entirely 
replaced by the signed quotient and 
remainder, as follows: 



2000 



2004 



Locations 2000-2004 



38 


46 


0D 


01 


8C 



quotient I remainder 



Notes: 



Because the dividend and divisor 
have different signs, the quotient 
receives a negative sign. 

The remainder receives the sign of 
the dividend and the length of the 
di vi sor. 

If an attempt were made to divide 
the dividend by the one-byte field 
at location 3001, the quotient 
would be too long to fit within the 
four bytes allotted to it. A 
decimal-divide exception would 
exist, causing a program inter- 
rupti on. 



EDIT (ED) 



Before decimal data in the packed format 

can be used in a printed report, digits 

and signs must be converted to printable 

characters. Moreover, punctuation 

marks, such as commas and decimal 
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points^ may have to be inserted in 
appropriate places. The highly flexible 
EDIT instruction performs thase func- 
tions in a single instruction execution. 

This example shows step-by-step one way 
that the EDIT instruction can be used. 
The field to be edited (the source) is 
four bytes long; it is edited against a 
pattern 13 bytes long. The following 
symbols are used: 



Symbol 


Meani ng 


b (Hexadecimal 40) 
( (Hexadecimal 21) 

d (Hexadecimal 20) 


Blank character 
Si gni f icance 

starter 
Digit selector 



Assume that register 12 contains: 

00 00 10 00 

and that the source and pattern fields 
are: 

Source 

1200 1203 



02 


57 


42 


6C 



Pattern 
1000 



100C 



40 


20 


20 


6B 


20 


21 


20 


4B 


20 


20 


40 


C3 


D9 



bdd,d(d.ddbCR 
Execution of the instruction: 
Machine Format 
Op Code L Bi Di B 2 D a 



DE 


OC 


C 


000 


c 


200 



Assembler Format 

Op Code Di (L,Bi),D a (B a ) 

ED 0(13,12),X'200'U2) 
alters the pattern field as follows: 
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Pattern 


Digit 


Si gni f i cance 

Indi cator 

(Before/After) 


Rule 


Locati on 
1000-100C 


b 
d 
d 



2 


off/off 
off/off 
off/on(2) 


leaved) 
fill 
di git 


bdd,d(d.ddbCR 
bbd,d(d.ddbCR 
bb2,d(d.ddbCR 


d 
( 
d 


5 
7 
4 


o o o o 

3 3 3 3 
N N N N 

o o o o 

3 3 3 3 


leave 
di gi t 
digit 
di git 


same 

bb2,5(d.ddbCR 
bb2,57d.ddbCR 
bb2,574.ddbCR 


d 
d 
b 
C 
R 


2 

6 + 


on/on 

on/on 

on/off(3) 

off/off 

off/off 

off/off 


leave 
di gi t 
di gi t 
fill 
fill 
fill 


same 

bb2,574.2dbCR 

bb2,574.26bCR 

same 

bb2,574.26bbR 

bb2,574.26bbb 


Notes: 


sharacte 


r is the fill byti 


3. 




1. This < 


2. First nonzero 


decimal source d 


igit turns < 


an significance 


i ndi cator. 








3. Plus sign in 


the four rightmost bits of the byte turns 


off significa 


ice indicator. 







Thus* after the instruction is executed* 
the pattern field contains the result as 
follows: 



Pattern 
1000 



100C 



40 


40 


F2 


6B 


F5 


F7 


F4 


4B 


F2 


F6 


40 


40 


40 



b b 2 



5 7 



b b b 



This pattern field prints as: 

2,574.26 

The source field remains unchanged. 
Condition code 2 is set because the 
number was greater than zero. 

If the number in the source field is 
changed to the negative number 00 00 02 
6D and the original pattern is used, the 
edited result this time is: 



Pattern 
1000 



100C 



40 


40 


40 


40 


40 


40 


F0 


4B 


F2 


F6 


40 


C3 


D9 



bbbbbbO . 2 6 b C R 

This pattern field prints as: 

0.26 CR 

The significance starter forces the 
significance indicator to the on state 
and hence causes a leading zero and the 
decimal point to be preserved. Because 
the minus-sign code has no effect on the 
significance indicator, the characters 



CR are printed to show a negative (cred- 
it) amount. 

Condition code 1 is set (number less 
than zero). 



EDIT AND MARK (EDMK) 



The EDIT 
used, in 
EDIT, to 
as a dol 
posi ti on 
the same 
1200-1203 
1000-100C 
general 
i nstructi 
contents 
not signi 
ti on is u 
posi ti on 
significa 



AND MARK 
addi ti on 
insert a 
lar sign, 
i n the ed 
source i 
, the same 
, and th 
regi ster 
on abov 
of general 
ficant; a 
sed to se 
that is f 
nt digits 



instruction may be 
to the functions of 
currency symbol, such 
at the appropriate 
ited result. Assume 
n storage locations 

pattern in locations 
e same contents of 
12 as for the EDIT 
e. The previous 

register 1 (GR1) are 
LOAD ADDRESS instruc- 
t up the first digit 
orced to print if no 
occur to the left. 



The instructions: 



LA 



1,6(0,12) 



Load address of 
forced significant 
digit into GR1 

EDMK 0(13,12),X'200'(12) Leave address 

of first signif- 
icant digit in GR1 

BCTR 1,0 Subtract 1 from 

address in GR1 
0(1), C^* Store dollar sign 
at address in GR1 



MVI 



produce the following results for 
two examples under EDIT: 



the 
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Pattern 
1000 



100C 



40 


5B 


F2 


6B 


F5 


F7 


F4 


4B 


F2 


F6 


40 


40 


40 



b$2,574.26bbb 

This pattern field prints as; 

$2,574.26 

Condition code 2 is set to indicate that 
the number edited Mas greater than zero. 



Pattern 
1000 



100C 



40 


40 


40 


40 


40 


5B 


F0 


4B 


F2 


F6 


40 


C3 


D9 



b b b b b $ . 2 6 b C R 

This pattern field prints as; 

$0.26 CR 

Condition code 1 is set because the 
number is less than zero. 



Now* after the instruction: 
Machine Format 
Op Code L t L a B, D, 



FC 


4 


1 


4 


100 


6 


000 



Assembler Format 

Op Code D, (L , ,B, ) ,D 2 (L 2 ,B 2 ) 

MP X f 100 f (5, 4), 0(2, 6) 

is executed, storage locations 1300-1304 
contain the product: 01 23 45 66 0C. 



SHIFT AND ROUND DECIMAL (SRP) 



The SHIFT AND ROUND DECIMAL (SRP) 
instruction can be used for shifting 
decimal numbers in storage to the left 
or right. When a number is shifted 
right, rounding can also be done. 



MULTIPLY DECIMAL (MP) 



Decimal Left Shift 



Assume that the signed, packed-decimal 
number in storage locations 1202-1204 
(the multiplicand) is to be multiplied 
by the signed, packed-decimal number in 
locations 500-501 (the multiplier). 

1202 1204 



Multiplicand 38 46 0D 



500 501 



32 


ID 



Multipli er 



The multiplicand must first be extended 
to have at least two bytes of leftmost 
zeros, corresponding to the multiplier 
length, so as to avoid a data exception 
during the multiplication. ZERO AND ADD 
can be used to move the multiplicand 
into a longer field. Assume: 

Register 4 contains 00 00 12 00. 
Register 6 contains 00 00 05 00. 

Then execution of the instruction: 

ZAP X , 100 , (5,4),2(3,4) 

sets up a new multiplicand in storage 
locations 1300-1304: 



1300 



1304 



Multiplicand (new) 



00 


00 


38 


46 


0D 



In this example, the contents of storage 
location FIELD1 are shifted three places 
to the left, effectively multiplying the 
contents of FIELD1 by 1000. FIELD1 is 
six bytes long. The following instruc- 
tion performs the operation: 



Machine Format 
Op Code L t 



S, 



F0 


5 





XKXX 





003 



Assembler Format 
Op Code S t (Li ),S 2 ,I 3 
SRP FIELD1(6),3,0 

FIELD1 (before): 00 01 23 45 67 8C 



FIELD1 (after): 



12 34 56 78 00 0C 



The second-operand address in this 
instruction specifies the shift amount 
(three places). The rounding digit, I 3 , 
is not used in a left shift, but it must 
be a valid decimal digit. After 
execution, condition code 2 is set to 
show that the result is greater than 
zero. 
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Decimal Right Shift 



Machine Format 



In this example, the contents of storage 
location FIELD2 are shifted one place to 
the right* effectively dividing the 
contents of FIELD2 by 10 and discarding 
the remainder. FIELD2 is five bytes in 
length. The following instruction 
performs this operation: 

Machine Format 



Op Code 


L, 


I 3 Si B 2 Dj 


i 


F0 


4 


xxxx 03F 






1 H H 1 



00111111 



6-bit two's 
complement 
for -1 



Assembler Format 

Op Code S,(Li ),S 2 ,I 3 



SRP 



FIELD2(5), 64-1,0 



FIELD 2 (before): 01 23 45 67 8C 

FIELD 2 (after): 00 12 34 56 7C 

In the SRP instruction, shifts to the 
right are specified in the second- 
operand address by negative shift 
values, which are represented as a 
six-bit value in two's complement form. 

The six-bit two's complement of a 
number, n, can be specified as 64 - n. 
In this example, a right shift of one is 
represented as 64 - 1. 

Condition code 2 is set. 



Decimal Ri ght Shi ft and Round 



In this example, the contents of storage 
location FIELD3 are shifted three places 
to the right and rounded, in effect 
dividing by 1000 and rounding up. 
FIELD3 is four bytes in length. 



Op Code L t I 3 S t B 2 D s 


i 


F0 3 5 xxxx 03D 


i H H 





00111101 

I . I 



6-bit two's 
complement 
for -3 



Assembler Format 

Op Code Si (Li ),S 2 ,I 3 



SRP 



FIELD3(4),64-3,5 



FIELD 3 (before): 12 39 60 0D 



FIELD 3 (after): 



00 01 24 0D 



The shift amount (three places) is spec- 
ified in the D 9 field. The I 3 field 
specifies a rounding digit of 5. The 
rounding digit is added to the last 
digit shifted out (which is a 6), and 
the carry is propagated to the left. 
The sign is ignored during the addition. 

Condition code 1 is set because the 
result is less than zero. 



Multiplvi ng by a Variable Power of 10 



Since the shift value specified by the 
SRP instruction specifies both the 
direction and amount of the shift, the 
operation is equivalent to multiplying 
the decimal first operand by 10 raised 
to the power specified by the shift 
value. 

If the shift value is to be variable, it 
may be specified by the B 2 field instead 
of the displacement D 2 of the SRP 
instruction. The general register 
designated by B 2 should contain the 
shift value (power of 10) as a signed 
binary integer. 

A fixed scale factor modifying the vari- 
able power of 10 may be specified by 
using both the B 2 field (variable part 
in a general register) and the D 2 field 
(fixed part in the displacement). 

The SRP instruction uses only the right- 
most six bits of the effective address 
D 2 (B 2 ) and interprets them as a six-bit 
signed binary integer to control the 
left or right shift as in the preceding 
shift examples. 
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ZERO AND ADD (ZAP) 

Assume that the signed, packed-decimal 
number at storage locations 4500-4502 is 
to be moved to locations 4000-4004 with 
four leading zeros in the result field. 
Also assume: 

Register 9 contains 00 00 40 00. 
Storage locations 4000-4004 contain 12 

34 56 78 90. 
Storage locations 4500-4502 contain 38 

46 0D. 

After the instruction: 
Machine Format 
Op Code L, L 2 B t D t B 3 D 2 



F8 


4 


2 


9 


000 


9 


500 



Assembler Format 

Op Code D, (L t ,B, ),D 2 (L 2 ,B 2 ) 

ZAP 0(5,9),X f 500'(3,9) 

is executed, the storage locations 
4000-4004 contain 00 00 38 46 0D; condi- 
tion code 1 is set to indicate a nega- 
tive result without overflow. 

Note that, because the first operand is 
not checked for valid sign and digit 
codes, it may contain any combination of 
hexadecimal digits before the operation. 



FLOATING-POINT INSTRUCTIONS 



(See Chapter 
tion of the 
ti ons. ) 



9 for a complete descrip- 
f loati ng-poi nt instruc- 



section, 
FPR4, and 



In this 

FPR2, FPR4, and FPR6 s 
floating-point registers 0, 2, 
respect i vely. 



the abbreviations FPR0, 

FPR6 stand for 

4, and 6 



ADD NORMALIZED (AD, ADR, AE, AER, AXR) 



The ADD NORMALIZED instruction performs 
the addition of two floating-point 
numbers and places the normalized result 
in a floating-point register. Neither 
of the two numbers to be added must 
necessarily be in normalized form before 
addition occurs. For example, assume 
that: 

FPR6 contains the unnormalized number 
C3 08 21 00 00 00 00 00 = -82.1(16} 
= -130.06(10} approximately. 

Storage locations 2000-2007 contain the 
normalized number 41 12 34 56 00 00 



00 00 = +1.23456(16} = +1.14(10} 
approximately. 
Register 13 contains 00 00 20 00. 

The instruction: 

Machine Format 

Op Code Ri X 2 B 2 D 2 



7A 


6 





D 


000 



Assembler Format 

Op Code Ri ,D 2 (X 2 ,B 2 ) 



AE 



6,0(0,13) 



performs the short-precision addition of 
the two operands, as follows. 

The characteristics of the two numbers 
(43 and 41) are compared. Since the 
number in storage has a characteristic 
that is smaller by 2, it is right- 
shifted two hexadecimal digit positions. 
One guard digit is retained on the 
right. The fractions of the two numbers 
are then added algebraically: 



FPR6 

Shifted number from 
storage 



Fraction GD 1 
-43 08 21 00 
+43 00 12 34 5 



Intermediate sum 
Left-shifted sum 

x Guard digit 



-43 08 0E CB 
-42 80 EC BB 



Because the intermediate sum is unnor- 
malized, it is left-shifted to form the 
normalized floating-point number 
-80.ECBB(16} = -128.92(10} approxi- 
mately. Combining the sign with the 
characteristic, the result i s C2 80 EC 
BB, which replaces the left half of 
FPR6. The right half of FPR6 and the 
contents of storage locations 2000-2007 
are unchanged. Condition code 1 is set 
to indicate a result less than zero. 

If the long-precision instruction AD 
were used, the result in FPR6 would be 
C2 80 EC BA A0 00 00 00. Note that use 
of the long-precision instruction would 
avoid a loss of precision in this exam- 
ple. 



ADD UNNORMALIZED (AU, AUR, AW, AWR) 



The ADD UNNORMALIZED instruction oper- 
ates the same as the ADD NORMALIZED 
instruction, except that the final 
result is not normalized. For example, 
using the the same operands as in the 
example for ADD NORMALIZED, when the 
short-precision instruction: 
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Machine Format 
Op Code Ri X 3 



7E 


6 





D 


000 



Assembler Format 

Op Code R,,D 3 (X 3 ,B 3 ) 



AU 



6,0(0,13) 



is executed, the two numbers are added 
as follows: 



FPR6 

Shifted number from 
storage 



Fraction GD 1 
-43 08 21 00 
+43 00 12 34 5 



Intermediate sum 
1 Guard digit 



-43 08 0E CB B 



The guard digit participates in the 
addition but is discarded. The unnor- 
malized sum replaces the left half of 
FPR6. Condition code 1 is set because 
the result is less than zero. 

The truncated result in FPR6 (C3 08 0E 
CB 00 00 00 00) shows a loss of a 
significant digit when compared to the 
result of short-precision normalized 
addi tion. 



number is 43 00 00 00 00 00 00 00, with 
a guard digit of one. Therefore, when 
the two numbers are compared, condition 
code lis set, indicating that operand 1 
in FPR4 is less than operand 2 in FPR6. 



If the example is chan 
operand with a charac 
instead of 35, so that 
12 34 56 78 9A BC DE, 
right-shi fted 15 positio 
fraction digits and the 
zeros. Condition code 
eating equality. This 
that two f loati ng-poi n 
different character! sti 
may compare equal if 
unnormalized or zero. 



ged to a second 
teristic of 34 
FPR6 contains 34 

the operand i s 
ns, leaving all 

guard digit as 
is set, indi- 
example shows 
t numbers with 
cs or fractions 
the numbers are 



As another example of comparing unnor- 
malized floating-point numbers, 41 00 12 
34 56 78 9A BC compares equal to all 
numbers of the form 3F 12 34 56 78 9A BC 
OX (X represents any hexadecimal digit). 
When the COMPARE instruction is 
executed, the two rightmost digits are 
shifted right two places, the becomes 
the guard digit, and the X does not 
participate in the comparison. 

However, when two normalized floating- 
point numbers are compared, the 
relationship between numbers that 
compare equal is unique: each digit in 
one number must be the same as the 
corresponding digit in the other number. 



COMPARE (CD, CDR, CE, CER) 

Assume that FPR4 contains 43 00 00 00 00 
00 00 00 (zero), and FPR6 contains 35 12 
34 56 78 9A BC DE (a positive number). 
The contents of the two registers are to 
be compared using a long-precision 
COMPARE instruction. 

Machine Format 

Op Code R, R a 



29 


4 


6 



DIVIDE (DD, DDR, DE, DER) 



Assume that the first operand (the divi- 
dend) is in FPR2 and the second operand 
(the divisor) in FPR0. If the operands 
are in the short-precision format, the 
resulting quotient is returned to FPR2 
by the instruction: 

Machine Format 



Op Code Ri 



3D 


2 






Assembler Format 
Op Code Rj ,R 3 



CDR 



4,6 



The number with the smaller character- 
istic, which is in register FPR6, is 
right-shifted 43 - 35 hex (67 - 53 deci- 
mal) or 14 digit positions, so that the 
two characteristics agree. The shifted 



Assembler Format 
Op Code Ri ,R 3 



DER 



2,0 



Several examples of short-precision 
floating-point division, with the divi- 
dend in FPR2 and the divisor in FPR0, 
are shown below. For case A, the 
result, which replaces the dividend, is 
obtained in the following steps. 
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7. 


2522F 


123400| .821000 
7F6C00 


2A400 
24680 






5D80 
5B04 


00 
00 


27C 
246 


000 
800 


35 
24 


8000 
6800 


11 
11 


18000 
10C00 



7400 



Case 


FPR2 Before 
(Di vi dend) 


FPRO 
(Di vi sor) 


FPR2 After 
(Quoti ent) 


A 
B 
C 
D 
E 


-43 082100 
+42 101010 
+48 30000F 
+48 30000F 
+48 180007 


+43 001234 
+45 111111 
+41 400000 
+41 200000 
+41 200000 


-42 72522F 
+3D FOFOFO 
+47 C0003C 
+48 180007 
+47 C00038 



Case C shows a number being divided by 
4.0. Case D divides the same number by 
2.0, and case E divides the result of 
case D again by 2.0. The results of 
cases C and E differ in the rightmost 
hexadecimal digit position, which illus- 
trates an effect of result truncation. 



HALVE (HDR, HER) 



HALVE produces the same result as 
floating-point DIVIDE with a divisor of 
2.0. Assume FPR2 contains the long- 
precision number +48 30 00 00 00 00 00 
OF. The following HALVE instruction 
produces the result +48 18 00 00 00 00 
00 07 in FPR2: 



Machine Format 
Op Code Rt R a 



24 


2 


2 



Assembler Format 
Op Code R t ,R a 



MULTIPLY (MD, MDR, ME, MER, MXD, MXDR, 
MXR) 



For this example, the following long- 
precision operands are in FPRO and FPR2: 

FPRO: -33 606060 60606060 
FPR2: -5A 200000 20000020 

A long-precision product is generated by 
the instruction: 

Machine Format 

Op Code R t R a 



2C 





2 



Assembler Format 
Op Code Rt >Ra 



MDR 



0,2 



If the operands were 
ized, the instruct 
normalize them. It 
intermediate result 
full 28-digit hexadec 
tion obtained by 
14-digit hexadecimal 
together with the app 
characteristic that 
operand characterist 
hex) : 



not already normal- 
ion would first 

then generates an 

consisting of the 

imal product frac- 

multiplying the 

operand fractions, 
ropriate sign and a 
i s the sum of the 
ics less 64 (40 



The fraction multiplication is performed 
as follows: 

.60606060606060 
.20000020000020 



HDR 



2,2 



cococococococoo 
cococococococo 
cococococococo 

.0C0C0C181818241818180C0C0C00 

Attaching the sign and characteristic to 
the fraction gives: 

+4D 0C0C0C 18181824 1818180C 0C0C00 

Because this intermediate product has a 
leading zero, it is then normalized. 
The truncated final result placed in 
FPRO is: 

+4C C0C0C1 81818241 



FLOATING-POINT-NUMBER CONVERSION 



The following examples illustrate one 
method of converting between binary 
fixed-point numbers (32-bit signed bina- 
ry integers) and normalized floating- 
point numbers. Conversion must provide 
for the different representations used 
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with negative numbers: the two's- 
complement form for signed binary 
integers, and the si gned-absolute-value 
form for the fractions of floating-point 
numbers. 



the number unchanged in floating-point 
register 2. The SUBTRACT NORMALIZED 
(SD) instruction performs the final two 
steps by subtracting 2 31 in floating- 
point form and normalizing the result. 



Fixed Point to Floating Point 



Floating Poi nt to Fixed Point 



The method used here inverts 
most bit of the 32-bit sig 
integer, which is equivalent 
2 31 to the number and consi 
result to be positive. This 
number from a signed integ 
range 2 31 - 1 through -2 
unsigned integer in the ran 
through 0. After conversion 
floating-point format, the v 
subtracted again. 



the 1 


eft- 


ned bi 


nary 


to adding 


dering 


the 


changes 


the 


er l n 


the 


31 to 


an 


ge 2 32 


- 1 


to the 


long 



alue 2 31 is 



Assume that general register 9 (GR9) 
contains the integer -59 in two's- 
complement form: 



GR9: 



FF FF FF C5 



Further, assume two eight-byte fields in 
storage: TEMP, for use as temporary 
storage, and TW031, which contains the 
floating-point constant 2 31 in the 
following format: 



TW031: 



4E 00 00 00 80 00 00 00 



This is an unnormalized long floating- 
point number with the characteristic 4E, 
which corresponds to a radix point (hex- 
adecimal point) to the right of the 
number. 



The following instruction 
performs the conversion: 



sequence 



9,TW031+4 



ST 9,TEMP+4 



MVC TEMP(4),TW031 



LD 2, TEMP 



SD 2,TW031 



Result 

GR9: 
7FFF FFC5 

TEMP: 

xxxx xxxx 7FFF FFC5 

TEMP: 

4E00 0000 7FFF FFC5 

FPR2: 

4E00 0000 7FFF FFC5 

FPR2: 

C23B 0000 0000 0000 



The EXCLUSIVE OR (X) instruction inverts 
the leftmost bit in general register 9, 
using the right half of the constant as 
the source for a leftmost one bit. The 
next two instructions assemble the modi- 
fied number in an unnormalized long 
floating-point format, using the left 
half of the constant as the plus sign, 
the characteristic, and the leading 
zeros of the fraction. LOAD (LD) places 



The procedure described here consists 
basically in reversing the steps of the 
previous procedure. Two additional 
considerations must be taken into 
account. First: the floating-point 
number may not be an exact integer. 
Truncating the excess hexadecimal digits 
on the right requires shifting the 
number one digit position farther to the 
right than desired for the final result, 
so that the units digit occupies the 
position of the guard digit. Second: 
the floating-point number may have to be 
tested as to whether it is outside the 
range of numbers representable as a 
32-bit signed binary integer. 

Assume that floating-point register 6 
contains the number 59. 25(10) = 3B.4U61 
in normalized form: 



FPR6: 



42 3B 40 00 00 00 00 00 



Further, assume three eight-byte fields 
in storage: TEMP, for use as temporary 
storage, and the constants 2 32 (TW032) 
and 2 31 (TW031R) in the following 
formats: 

TW032: 4E 00 00 01 00 00 00 00 
TW031R: 4F 00 00 00 08 00 00 00 

The constant TW031R is shifted right one 
more position than the constant TW031 of 
the previous example, so as to force the 
units digit into the guard-digit posi- 
tion. 

The following instruction sequence 
performs the integer truncation, range 
tests, and conversion to a signed binary 
integer in general register 8 (GR8): 



SD 6,TW031R 

BC 11, OVERFLOW 

AM 6,TW032 

BC 4, OVERFLOW 

STD 6, TEMP 

XI TEMP+4,X f 80* 

L 8,TEMP+4 



Result 

FPR6: 

C87F FFFF 

Branch to 
routine 
i s great 
equal to 

FPR6: 

4E00 0000 

Branch to 
routi ne 
is less 

TEMP: 

4E00 0000 

TEMP: 

4E00 0000 

GR8: 

0000 003B 



C500 0000 
overflow 
if result 
er than or 
zero 

8000 003B 
overflow 
if result 
than zero 

8000 003B 

0000 003B 
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The SUBTRACT NORMALIZED (SD) instruction 
shifts the fraction of the number to the 
right until it lines up with TW031R, 
which causes the fraction digit 4 to 
fall to the right of the guard digit and 
be lost; the result of subtracting 2 31 
from the remaining digits is renormal- 
ized. The result should be lass than 
zero; if not, the original number was 
too large in the positive direction. 
The first BRANCH ON CONDITION (BC) 
performs this test. 

The ADD UNNORMALIZED (AW) instruction 
adds 2 32 : 2 31 to correct for the previ- 
ous subtraction and another 2 31 to 
change to an all-positive range. The 
second BC tests for a result less than 
zero, showing that the original number 
was too large in the negative direction. 
The unnormalized result is placed in 
temporary storage by the STORE (STD) 
instruction. There the leftmost bit of 
the binary integer is inverted by the 
EXCLUSIVE OR (XI) instruction to 
subtract 2 31 and thus convert the 
unsigned number to the signed format. 
The final result is loaded into GR8. 



Execution of 




Execution of 


i nstruction 




i nstructi on 


01 FLAGS, X'01' 


FLAGS 


01 FLAGS, X*80» 


on CPU A 




on CPU B 




X'OO' 


Fetch 
FLAGS X'OO' 


Fetch 


X f 00» 




FLAGS X'OO' 








X'OO* 


OR X f 80' 
into X'00 f 


OR X'01' 


X f 00 f 




into X'OO' 








X f 80« 


Store X'80» 
into FLAGS 


Store X'01* 


X'01' 




into FLAGS 






FLAGS should have value of X f 81» 


following both updates. 



The problem shown here is that the value 
stored by the 01 instruction executed on 
CPU A overlays the value that was stored 
by CPU B. The X"80 f flag bit was erro- 
neously turned off, and the data is now 
invali d. 



MULTIPROGRAMMING AND MULTIPROCESSING 
EXAMPLES 



The COMPARE AND SWAP instruction has 
been provided to overcome this and simi- 
lar problems. 



When two or more programs sharing common 
storage locations are being executed 
concurrently in a multiprogramming or 
multiprocessing environment, one program 
may, for example, set a flag bit in the 
common-storage area for testing by 
another program. It should be noted 
that the instructions AND (NI or NO, 
EXCLUSIVE OR (XI or XC), and OR (01 or 
0C) could be used to set flag bits in a 
multiprogramming environment; but the 
same instructions may cause program 
logic errors in a multiprocessing 
configuration where two or more CPUs can 
fetch, modify, and store data in the 
same storage locations simultaneously. 



EXAMPLE OF A PROGRAM FAILURE USING OR 
IMMEDIATE 



Assume that two independen 
to set different bits to o 
byte in storage. The fol 
shows how the use of the 
immediate (01) can fail 
this, if the programs 
simultaneously on two di 
One of the possible error 
depicted. 



t programs try 
ne in a common 
lowing example 
instruction OR 
to accomplish 

are executed 
fferent CPUs. 

situations is 



CONDITIONAL SWAPPING INSTRUCTIONS (CS, 
CDS) 



The COMPARE AND SWAP (CS) and COMPARE 
DOUBLE AND SWAP (CDS) instructions can 
be used in multiprogramming or multi- 
processing environments to serialize 
access to counters, flags, control 
words, and other common storage areas. 

The following examples of the use of the 
COMPARE AND SWAP and COMPARE DOUBLE AND 
SWAP instructions illustrate the appli- 
cations for which the instructions are 
intended. It is important to note that 
these are examples of functions that can 
be performed by programs while the CPU 
is enabled for interruption (multipro- 
gramming) or by programs that are being 
executed in a multiprocessing configura- 
tion. That is, the routine allows a 
program to modify the contents of a 
storage location while the CPU is 
enabled, even though the routine may be 
interrupted by another program on the 
same CPU that will update the location, 
and even though the possibility exists 
that another CPU may simultaneously 
update the same location. 

The COMPARE AND SWAP instruction first 
checks the value of a storage location 
and then modifies it only if the value 
is what the program expects; normally 
this would be a previously fetched 
value. If the value in storage is not 
what the program expects, then the 
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location is not modified; instead, the 
current value of the location is loaded 
into a general register, in preparation 
for the program to loop back and try 
again. During the execution of COMPARE 
AND SWAP, no other CPU can perform a 
store access or i nterlocked-update 
access at the specified location. 



Setti ng a Si ngle Bi t 



The following instruction sequence shows 
how the COMPARE AND SWAP instruction can 
be used to set a single bit in storage 
to one. Assume that the first byte of a 
word in storage called "WORD" contains 
eight flag bits. 



LA 6,X'80* 
SLL 6,24 



RETRY LR 
OR 
CS 



7, WORD 

8,7 
8,6 
7, 8, WORD 



BC 4, RETRY 



Put bit to be ORed 
into GR6 

Shift left 24 places 
to align the byte 
to be ORed with 
the location of 
the flag bits 
within WORD 

Fetch current flag 
values 

Load flags into GR8 

Set bit to one 

Store new flags if 
current flags un- 
changed, or re- 
fetch current 
flag values if 
changed 

If new flags are not 
stored, try again 



The format of the COMPARE AND SWAP 
instruction is: 

Machine Format 

Op Code R t R 3 S 2 



BA 


7 


8 


XKXX 



Assembler Format 
Op Code Ri ,R 3 ,S 2 



CS 



7, 8, WORD 



The COMPARE 
compares the 
register 7 co 
values) to the 
(WORD) while 
executing the 
tion is permi 
access or int 
the specified 



AND SWAP instruction 
first operand (general 
ntaining the current flag 
second operand in storage 
no CPU other than the one 
COMPARE AND SWAP instruc- 
tted to perform a store 
erlocked-update access at 
storage location. 



If the comparison is successful, indi- 
cating that the flag bits have not been 
changed since they were fetched, the 
modified copy in general register 8 is 



stored into WORD. If the flags have 
been changed, the compare will not be 
successful, and their new values are 
loaded into general register 7. 

The conditional branch (BC) instruction 
tests the condition code and reexecutes 
the flag-modifying instructions if the 
COMPARE AND SWAP instruction indicated 
an unsuccessful comparison (condition 
code 1). When the COMPARE AND SWAP 
instruction is successful (condition 
code 0), the flags contain valid data, 
and the program exits from the loop. 

The branch to RETRY will be taken only 
if some other program modifies the 
contents of WORD. This type of a loop 
differs from the typical "bit-spin" 
loop. In a bit-spin loop, the program 
continues to loop until the bit changes. 
In this example, the program continues 
to loop only if the value does change 
during each iteration. If a number of 
CPUs simultaneously attempt to modify a 
single location by using the sample 
instruction sequence, one CPU will fall 
through on the first try, another will 
loop once, and so on until all CPUs have 
succeeded. 



Updati ng Counters 



In this example, a 32-bit counter is 
updated by a program using the COMPARE 
AND SWAP instruction to ensure that the 
counter will be correctly updated. The 
original value of the counter is 
obtained by loading the word containing 
the counter into general register 7. 
This value is moved into general regis- 
ter 8 to provide a modifiable copy, and 
general register 6 (containing an incre- 
ment to the counter) is added to the 
modifiable copy to provide the updated 
counter value. The COMPARE AND SWAP 
instruction is used to ensure valid 
storing of the counter. 

The program updating the counter checks 
the result by examining the condition 
code. The condition code indicates a 
successful update, and the program can 
proceed. If the counter had been 
changed between the time that the 
program loaded its original value and 
the time that it executed the COMPARE 
AND SWAP instruction, the execution 
would have loaded the new counter value 
into general register 7 and set the 
condition code to 1, indicating an 
unsuccessful update. The program must 
then repeat the update sequence until 
the execution of the COMPARE AND SWAP 
instruction results in a successful 
update. 



The following instruction 
performs the above procedure: 



sequence 
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LA 



LOOP LR 

AR 
CS 

BC 



6,1 Put increment (1) into 

GR6 
7, CNTR Put original counter 

value into GR7 
8,7 Set up copy in GR8 to 

modi fy 
8,6 Increment copy 
7, 8, CNTR Update counter in 

storage 
4, LOOP If original value had 

changed, update new 

value 



The following shows two CPUs, A and B, 
executing this instruction sequence 
simultaneously: both CPUs attempt to 
add one to CNTR. 



CPU A 
GR7 GR8 



16 16 



CNTR 
16 



CPU B 
GR7 GR8 



16 16 
17 



17 



17 



17 



18 



18 



Comments 



CPU A loads GR7 

and GR8 from 

CNTR 
CPU B loads GR7 

and GR8 from 

CNTR 
CPU B adds one 

to GR8 
CPU A adds one 

to GR8 
CPU A executes 

CS; successful 

match, store 
CPU B executes 

CS; no match, 

GR7 changed to 

CNTR value 
CPU B loads GR8 

from GR7, adds 

one to GR8 
CPU B executes 

CS; successful 

match, store 



HSPOST 



OR 


0,5 


Set bit 1 of 
GR1 to one 


L 


3,0(1) 


GR3 = contents 
of ECB 


LTR 


3,3 


ECB marked 
f wai ti ng* ? 


BC 


4,PSVC 


Yes, execute 
post 
SVC 


CS 


3,0,0(1) 


No, store post 
code 


BC 


8,EXITHP 


Conti nue 


POST 


(1),(0) 


ECB address i s 
in GR1, post 
code in GRO 



PSVC 



EXITHP [Any instruction] 

The following routine may be used in 
place of the previous HSPOST routine if 
it is assumed that bit 1 of the contents 
of GRO is already set to one and if the 
ECB is assumed to contain zeros when it 
is not marked "WAITING." 



HSPOST 


SR 


3,3 




CS 


3,0,0(1) 




BC 


8, EXITHP 




POST 


(1),(0) 


EXITHP 


[Any 


instructi on] 



BYPASS WAIT Routine 



A BYPASS WAIT function, corresponding to 
the BYPASS POST, does not use the CS 
instruction, but the FIFO LOCK/UNLOCK 
routines which follow assume its use. 



HSWAIT 



EXITHW 



TM 
BC 



WAIT 
[Any 



0(1), X^O 1 
1, EXITHW 



If bit 1 is one, 
then ECB is al- 
ready posted; 
branch to exit 



ECB=(1) 
instructi on] 



BYPASSING POST AND WAIT 



BYPASS POST Routine 



The following routine allows the SVC 
"POST" as used in OS/VS to be bypassed 
whenever the corresponding WAIT has not 
yet been executed, provided that the 
supervisor WAIT and POST routines use 
COMPARE AND SWAP to manipulate event 
control blocks (ECBs). 

Initial Conditions: 

GRO contains the POST code. 
GR1 contains the address of the ECB. 
I GR5 contains 40 00 00 00(16} 



LOCK/UNLOCK 



When a common storage area larger than a 
doubleword is to be updated, it is 
usually necessary to provide special 
interlocks to ensure that a single 
program at a time updates the common 
area. Such an area is called a serially 
reusable resource (SRR). 

In general, updating a list, or even 
scanning a list, cannot be safely accom- 
plished without first "freezing" the 
list. However, the COMPARE AND SWAP and 
COMPARE DOUBLE AND SWAP instructions can 
be used in certain restricted situations 
to perform queuing and list 
manipulation. Of prime importance is 
the capability to perform the 
lock/unlock functions and to provide 
sufficient queuing to resolve 
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contentions^ either in a LIFO or FIFO 
manner. The lock/unlock functions can 
then be used as the interlock mechanism 
for updating an SRR of any complexity. 

The lock/unlock functions are based on 
the use of a "header" associated with 
the SRR. The header is the common 
starting point for determining the 
states of the SRR, either free or in 
use, and also is used for queuing 
requests when contentions occur. 
Contentions are resolved using WAIT and 
POST. The general programming technique 
requires that the program that encount- 
ers a "locked" SRR must "leave a mark on 
the wall" indicating the address of an 
ECB on which it will WAIT. The "unlock- 
ing" program sees the mark and posts the 
ECB, thus permitting the waiting program 
to continue. In the two examples given, 
all programs using a particular SRR must 
use either the LIFO queuing scheme or 
the FIFO scheme; the two cannot be 
mixed. When more complex queuing is 
required, it is suggested that the queue 
for the SRR be locked using one of the 
two methods shown. 



LOCK/UNLOCK with 
Contenti ons 



LIFO Queui ng for 



• A zero value indicates that the 
serially reusable resource (SRR) is 
free. 

• A negative value indicates that the 
SRR is in use but no additional 
programs are waiting for the SRR. 

• A positive value indicates that the 
SRR is in use and that one or more 
additional programs are waiting for 
the SRR. Each waiting program is 
identified by an element in a 
chained list. The positive value 
in the header is the address of the 
element most recently added to the 
list. 

Each element consists of two words. The 
first word is used as an ECB; the second 
word is used as a pointer to the next 
element in the list. A negative value 
in a pointer indicates that the element 
is the last element in the list. The 
element is required only if the program 
finds the SRR locked and desires to be 
placed in the list. 

The following chart describes the action 
taken for LIFO LOCK and LIFO UNLOCK 
routines. The routines following the 
chart allow enabled code to perform the 
actions described in the chart. 



The header consists of a word, that is, 
a four-byte field aligned on a word 
boundary. The word can contain zero, a 
positive value, or a negative value. 





Acti on 


Header Contains 


Header Contains 


Header Contains 


Functi on 


Zero 


Positive Value 


Negative Value 


LIFO LOCK 


SRR is free. 


SRR is in use. Store the 


(the incoming 


Set the header 


contents of the header into 


element is at 


to a negative 


location A+4. Store address A 


location A) 


value. Use the 


into the header. WAIT; the ECB 




SRR. 


i s at locati on A. 


LIFO UNLOCK 


Error 


Some program i s 


The list is 






waiting for the 


empty. Store 






SRR. Move the 


zeros into the 






pointer from 


header. The SRR 






the "last in" 


is free. 






element into 








the header. 








POST; the ECB 








is in the "last 








in" element. 





Appendix A. Number Representation and Instruction-Use Examples A-43 



LIFO LOCK Routine : 

Initial Conditions: 

GR1 contains the address of the incom- 
ing element. 
GR2 contains the address of the header, 



LLOCK 



SR 
ST 
LNR 



TRYAGN CS 



BC 



ST 



CS 



LA 
BC 



USE 



GR3 = 

Initialize the ECB 

GRO = a negative 
value 

Set the header to 
a negative value 
if the header 
contains zeros 

Did the header 
contain zeros? 

No, store the 
value of the 
header into the 
pointer in the 
incoming element 

Store the address 
of the incoming 
element into the 
header 

GR3 = 

Did the header get 
updated? 

Yes, wait for the 
resource; the 
ECB is in the 
incoming element 
i nstruction] 



3,3 

3,0(1) 

0,1 

3,0,0(2) 



8, USE 
3,4(1) 

3,1,0(2) 



3,0(0) 
7, TRYAGN 



WAIT ECB=(1) 



[Any 



LIFO UNLOCK Routine : 
Initial Conditions: 
GR2 contains the address of the header, 



LUNLK 


L 


1,0(2) 


GR1 = the contents 










of the header 


A 


LTR 


1,1 




Does the header 
contain a neg- 




BC 


4,B 




ative value? 




L 


0,4(1) 


No, load the 




CS 


1,0, 


0(2) 


pointer from the 
"last in" element 
and store it in 
the header 




BC 


7, A 




Did the header get 
updated? 




POST 


(1) 




Yes, post the "last 
in" element 




BC 


15, EXIT 


Continue 


B 


SR 


0,0 




The header contains 




CS 


1,0, 


0(2) 


a negative value; 
free the header 




BC 


7, A 




and continue 


EXIT 


[Any 


instruct 


ion] 



Note that the LOAD instruction L 1,0(2) 
at location LUNLK would have to be CS 
1,1,0(2) if it were not for the rule 
concerning storage-operand consistency. 
This rule requires the LOAD instruction 
to fetch a foui — byte operand aligned on 
a word boundary such that, if another 
CPU changes the word being fetched by an 
operation which is also at least word- 
consistent, either the entire new or the 



entire old value of the word is 
obtained, and not a combination of the 
two. (See the section "Storage-Operand 
Consistency" in Chapter 5, "Program 
Executi on.") 



LOCK/UNLOCK with FIFO Queuing for 
Content i ons 



The header always contains the address 
of the most recently entered element. 
The header is originally initialized to 
contain the address of a posted ECB. 
Each program using the serially reusable 
resource (SRR) must provide an element 
regardless of whether contention occurs. 
Each program then enters the address of 
the element which it has provided into 
the header, while simultaneously it 
removes the address previously contained 
in the header. Thus, associated with 
any particular program attempting to use 
the SRR are two elements, called the 
"entered element" and the "removed 
element." The "entered element" of one 
program becomes the "removed element" 
for the immediately following program. 
Each program then waits on the removed 
element, uses the SRR, and then posts 
the entered element. 



When no conte 
the second p 
use the SRR 
program is f 
the first pro 
of the secon 
the bypass-po 
described in 
applicable, 
routines are 
than as indiv 



ntion occurs, that is, when 
rogram does not attempt to 
until after the first 
inished, then the POST of 
gram occurs before the WAIT 
d program. In this case, 
st and bypass-wait routines 

the preceding section are 
For simplicity, these two 

shown only by name rather 
idual instructions. 



In the example, the element need be only 
a single word, that is, an ECB. 
However, in actual practice, the element 
could be made larger to include a point- 
er to the previous element, along with a 
program identification. Such informa- 
tion would be useful in an error 
situation to permit starting with the 
header and chaining through the list of 
elements to find the program currently 
holding the SRR. 

It should be noted that the element 
provided by the program remains pointed 
to by the header until the next program 
attempts to lock. Thus, in general, the 
entered element cannot be reused by the 
program. However, the removed element 
is available, so each program gives up 
one element and gains a new one. It is 
expected that the element removed by a 
particular program during one use of the 
SRR would then be used by that program 
as the entry element for the next 
request to the SRR. 

It should be noted that, since the 
elements are exchanged from one program 
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to the next/ the elements cannot be 
allocated from storage that would be 
freed and reused when the program ends. 
It is expected that a program would 
obtain its first element and release its 
last element by means of the routines 
described in the section "Free-Pool 
Manipulation" in this appendix. 

The following chart describes the action 
taken for FIFO LOCK and FIFO UNLOCK. 



Functi on 


Acti on 


FIFO LOCK 

(the incoming 
element is at 
location A) 


Store address A 
into the header. 
WAIT; the ECB is at 
the location addres- 
sed by the old con- 
tents of the header. 


FIFO UNLOCK 


POST; the ECB is at 
location A. 



The following routines allow enabled 
code to perform the actions described in 
the previous chart. 

FIFO LOCK Routine: 



FIFO UNLOCK Routine : 
Initial conditions: 



GR2 contains 
element, 
routi ne. 

GR5 contains 



the address of the removed 
obtained during the FLOCK 

40 00 00 00(16} 



FUNLK 



LR 1,2 



SR 
OR 



0,0 
0,5 



HSPOST 



Place address of en- 
tered element in 
GR1; GR1 = address 
of ECB to be posted 

GR0 = 0; GR0 has a 
post code of zero 

Set bit 1 of GR0 to 
one 

Perform bypass-post 
routine; if ECB has 
not been waited on, 
then mark posted 
and continue; if it 
has been waited on, 
then post 
CONTINUE [Any instruction] 



FREE-POOL MANIPULATION 



Initial conditions: 

GR3 contains the address of the header. 

GR4 contains the address, A, of the 
element currently owned by this 
program. This element becomes the 
entered element. 

FLOCK LR 2,4 GR2 now contains 

address of ele- 
ment to be 
entered 

SR 1,1 GR1 = 

ST 1,0(2) Initialize the ECB 

L 1,0(3) GR1 = contents of 
the header 
TRYAGN CS 1,2,0(3) Enter address A 

into header 

BC 7, TRYAGN while remember- 
ing old contents 
of header into 
GR1; GR1 now 
contains address 
of removed 
element 

LR 4,1 Removed element 

becomes new cui — 
rently owned 
element 

HSWAIT Perform bypass- 
wait routine; if 
ECB already 
posted, con- 
tinue; if not, 
wait; GR1 con- 
tains the ad- 
dress of the ECB 
USE [Any instruction] 



It is anticipated that a program will 
need to add and delete items from a free 
list without using the lock/unlock 
routines. This is especially likely 
since the lock/unlock routines require 
storage elements for queuing and may 
require working storage. The 
lock/unlock routines discussed previous- 
ly allow simultaneous lock routines but 
permit only one unlock routine at a 
time. In such a situation, multiple 
additions and a single deletion to the 
list may all occur simultaneously, but 
multiple deletions cannot occur at the 
same time. In the case of a chain of 
pointers containing free storage 
buffers, multiple deletions along with 
additions can occur simultaneously. In 
this case, the removal cannot be done 
using the COMPARE AND SWAP instruction 
without a certain degree of exposure. 



Consider a chained list 
in the LIFO lock/unlock 
that the first two 
locations A and B, resp 
program attempted to 
element and was interr 
fourth and fifth inst 
LUNLK routine, the list 
so that elements A and 
two elements when 
program resumes executi 
AND SWAP instruction w 
in storing the value B 
thereby destroying the 



of the type used 

example. Assume 

elements sre at 

ectively. If one 

remove the first 

upted between the 

ructions of the 

could be changed 

C are the f i rst 

the interrupted 

on. The COMPARE 

ould then succeed 

into the header, 

list. 



The probability of the occurrence of 
such list destruction can be reduced to 
near zero by appending to the header a 
counter that indicates the number of 
times elements have been added to the 
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list. The use of a 32-bit counter guar- 
antees that the list Mill not be 
destroyed unless the following events 
occur, in the exact sequence: 

1. An unlock routine is interrupted 
between the fetch of the pointer 
from the first element and the 
update of the header. 

2. The list is manipulated, including 
the deletion of the element refer- 
enced in 1, and exactly 2 32 -l addi- 
tions to the list are performed. 
Note that this takes on the order 
of days to perform in any practical 
si tuati on. 



The element referenced 
added to the list. 



in 



i s 



4. The unlock routine interrupted in 1 
resumes execution. 

The following routines use such a count- 
er in order to allow multiple, simul- 
taneous additions and removals at the 
head of a chain of pointers. 



The list consi 
and a chain of 
of the header 
first element 
word of the 
counter indica 
tions that ha 
Each element 
next element i 
indicates the 



sts of a doubleword header 
elements. The first word 
contains a pointer to the 
in the list. The second 
header contains a 32-bit 
ting the number of addi- 
ve been made to the list, 
contains a pointer to the 
n the list. A zero value 
end of the list. 



The following chart describes the free- 
pool-list manipulation. 



Function 


Acti on 


Header = 0, Count 


Header = A, Count 


ADD TO LIST 
(the incoming 
element is at 
location A) 


Store the first word of the header into 
location A. Store the address A into the 
first word of the header. Decrement the 
second word of the header by one. 


DELETE FROM 
LIST 


The list is empty. 


Set the first word of the 
header to the value of 
the contents of location 
A. Use element A. 
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The following routines allow enabled 
code to perform the free-pool-list 
manipulation described in the above 
chart. 

ADD JO FREE LIST Routine : 

Initial Conditions: 

GR2 contains the address of the element 

to be added. 
GR4 contains the address of the header. 

ADDQ LM 0,1,0(4) GR0,GR1 = contents 

of the header 
TRYAGN ST 0,0(2) Point the new ele- 
ment to the top 
of the li st 

LR 3,1 Move the count to 
GR3 

BCTR 3,0 Decrement the count 

CDS 0,2,0(4) Update the header 

BC 7, TRYAGN 



Note that the LM (LOAD MULTIPLE) 
instructions at locations ADDQ and 
DELETQ would have to be CDS (COMPARE 
DOUBLE AND SWAP) instructions if it were 
not for the rule concerning storage- 
operand consistency. This rule requires 
the LOAD MULTIPLE instructions to fetch 
an eight-byte operand aligned on a 
doubleword boundary such that, if anoth- 
er CPU changes the doubleword being 
I fetched by an operation which is also at 
I least doubleword-consi stent , either the 
entire new or the entire old value of 
the doubleword is obtained, and not a 
combination of the two. (See the 
section "Storage-Operand Consistency" in 
Chapter 5, "Program Execution.") 



DELETE FROM FREE LIST Routine : 
Initial conditions: 
GR4 contains the address of the header. 



DELETQ 


LM 


2,3,0(4) 


GR2,GR3 = con- 
tents of the 
header 


TRYAGN 


LTR 


2,2 


Is the list 
empty? 




BC 


8, EMPTY 


Yes, get help 




L 


0,0(2) 


No, GRO = the 
pointer from 
the first 
element 




LR 


1,3 


Move the count 
to GR1 




CDS 


2,0,0(4) 


Update the 
header 



BC 7, TRYAGN 
USE [Any instruction] The address of 

the removed 
element is in 
GR2 
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APPENDIX B. LISTS OF INSTRUCTIONS 



The following figures list instructions 
by name, mnemonic, and operation code. 
Some models may offer instructions that 
do not appear in the figures, such as 
those provided for assists or as part of 
special or custom features. 

The operation codes for the vector 
facility and for interpretive execution 
are not included in this appendix. See 
the publications IBM System/370 Vector 
Operations , SA22-7125, and IBM 
System/370 Extended Archi tecture Intel — 
preti ve Executi on , SA22-7095, for 
operation codes associated with these 
faci li ti es. 

The operation code 00 hex with a 
two-byte instruction format is allocated 
for use by the program when an indi- 
cation of an invalid operation is 
required. It is improbable that this 
operation code will ever be assigned to 
an instruction implemented in the CPU. 



Explanation of Symbols i n "Character- 
i sti cs" and "Page" Columns 



<r Causes serialization and check- 
point synchronization. 

C 1 Causes serialization and check- 
point synchronization when the Mi 
and R 2 fields contain all ones 
and all zeros, respectively. 

$ Causes serialization. 

A Access exceptions for logical 
addresses. 

A 1 Access exceptions; not all access 
exceptions may occur; see 
instruction description for 
detai Is. 

AI Access exceptions for instruction 
address. 

AS Access exceptions and A5N- 

translation-speci fi cation excep- 
tion; see instruction description 
for details. 

AT ASN-translati on exceptions (which 
include addressing, 
ASN-translati on specification, 
AFX translation, and ASX transla- 
ti on) . 

B PER branch event. 

C Condition code is set. 

D Data exception. 

DF Decimal-overflow exception. 

DK Decimal-divide exception. 

DM Depending on the model, DIAGNOSE 
may generate various program ex- 
ceptions and may change the con- 
dition code. 

E E instruction format. 



EO 
EU 
EX 
FK 
GO 



Gl 
G2 
GM 
GS 



IF 
II 
IK 
L 

LS 
I MI 
MO 
OP 
P 
Q 



RR 

RRE 

RS 

RX 

S 

SI 

SO 

SP 

ss 

SSE 
ST 

T 



Exponent-overflow exception. 
Exponent-underflow exception. 
Execute exception. 
Floating-point-divide exception. 
Instruction execution includes 
the implied use of general regis- 
ter 0. 
Instructi on 
the implied 
ter 1. 
Instructi on 
the implied 
ter 2. 
Instructi on 
the implied 



execution includes 
use of general regi s- 

execution includes 
use of general regi s- 



execution includes 
use of multiple 
general registers. 
Instruction execution includes 
the implied use of general regis- 
ter 1 as the subsystem-identifi- 
cation word. 

Fixed-point-overflow exception. 
Interrupti ble instruction. 
Fixed-point-divide exception. 
New condition code is loaded. 
Significance exception. 
Move-inverse facility. 
Monitor event. 
Operand exception. 
Privileged-operation exception. 
Privileged-operation exception 
for semi pri vi leged instructions. 
PER general-register alteration 
event. 

RR instruction format. 
RRE instruction format. 
RS instruction format. 
RX instruction format. 
S instruction format. 
SI instruction format. 
Special-operation exception. 
Specification exception. 
SS instruction format. 
SSE instruction format. 
PER storage-alteration event. 
Trace exceptions (which include 
trace table, addressing, and 
low-address protection). 
Additional exceptions and events 
for PROGRAM CALL (which include 
addressing, EX translation, LX 
translation, PC-translation spe- 
cification, and special-operation 
exceptions and space-switch 
event) . 

Additional exceptions and events 
for PROGRAM TRANSFER (which 
include addressing, primary- 
authority, and special-operation 
exceptions and space-switch 
event) . 

Additional exceptions for SET 
SECONDARY ASN (which include ad- 
dressing, secondary authority, 
and special operation). 
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Name 


Mne- 
moni c 


Characteri sti cs 


Op 
Code 


Page 
No. 


ADD 

ADD 

ADD DECIMAL 

ADD HALFWORD 

ADD LOGICAL 


AR 

A 

AP 

AH 

ALR 


RR C 
RX C 
SS C 
RX C 
RR C 


A 
A 
A 


IF 

IF 

D DF 

IF 


R 
R 

ST 
R 
R 


1A 
5A 
FA 
4A 
IE 


7-8 
7-8 
8-5 
7-8 
7-9 


ADD LOGICAL 

ADD NORMALIZED (extended) 
ADD NORMALIZED (long) 
ADD NORMALIZED (long) 
ADD NORMALIZED (short) 


AL 

AXR 

ADR 

AD 

AER 


RX C 
RR C 
RR C 
RX C 
RR C 


A 

SP 
SP 

A SP 
SP 


EU EO LS 
EU EO LS 
EU EO LS 
EU EO LS 


R 


5E 
36 
2A 
6A 
3A 


7-9 
9-6 
9-6 
9-6 
9-6 


ADD NORMALIZED (short) 
ADD UNNORMALIZED (long) 
ADD UNNORMALIZED (long) 
ADD UNNORMALIZED (short) 
ADD UNNORMALIZED (short) 


AE 

AWR 

AW 

AUR 

AU 


RX C 
RR C 
RX C 
RR C 
RX C 


A SP 
SP 

A SP 
SP 

A SP 


EU EO LS 
EO LS 
EO LS 
EO LS 
EO LS 




7A 
2E 
6E 
3E 
7E 


9-6 
9-7 
9-7 
9-7 
9-7 


AND 

AND 

AND (character) 

AND (immediate) 

BRANCH AND LINK 


NR 

N 

NC 

NI 

BALR 


RR C 
RX C 
SS C 
SI C 

RR 


A 
A 
A 


T 


R 

R 
ST 
ST 
B R 


14 
54 
D4 
94 
05 


7-9 
7-9 
7-9 
7-9 
7-10 


BRANCH AND LINK 

BRANCH AND SAVE 

BRANCH AND SAVE 

BRANCH AND SAVE AND SET MODE 

BRANCH AND SET MODE 


BAL 

BASR 

BAS 

BASSM 

BSM 


RX 
RR 
RX 
RR 
RR 




T 
T 


B R 
B R 
B R 
B R 
B R 


45 
OD 
4D 
OC 
OB 


7-10 
7-11 
7-11 
7-11 
7-12 


BRANCH ON CONDITION 
BRANCH ON CONDITION 
BRANCH ON COUNT 
BRANCH ON COUNT 
BRANCH ON INDEX HIGH 


BCR 

BC 

BCTR 

BCT 

BXH 


RR 
RX 
RR 
RX 
RS 




* x 


B 
B 

B R 
B R 
B R 


07 
47 
06 
46 
86 


7-12 
7-12 
7-13 
7-13 
7-13 


BRANCH ON INDEX LOW OR EQUAL 

CLEAR SUBCHANNEL 

COMPARE 

COMPARE 

COMPARE (long) 


BXLE 

CSCH 

CR 

C 

CDR 


RS 

S C 
RR C 
RX C 
RR C 


P 

A 

SP 


OP <? GS 


B R 


87 

B230 

19 

59 

29 


7-14 
14-3 
7-14 
7-14 
9-8 


COMPARE (long) 

COMPARE (short) 

COMPARE (short) 

COMPARE AND FORM CODEWORD 

COMPARE AND SWAP 


CD 

CER 

CE 

CFC 

CS 


RX C 
RR C 
RX C 
S C 
RS C 


A SP 
SP 
A SP 
A SP 
A SP 


II GM 
$ 


R 
R ST 


69 

39 

79 

B21A 

BA 


9-8 

9-8 

9-8 

7-15 

7-19 


COMPARE DECIMAL 
COMPARE DOUBLE AND SWAP 
COMPARE HALFWORD 
COMPARE LOGICAL 
COMPARE LOGICAL 


CP 

CDS 

CH 

CLR 

CL 


SS C 
RS C 
RX C 
RR C 
RX C 


A 

A SP 

A 

A 


D 

$ 


R ST 


F9 
BB 
49 
15 
55 


8-5 

7-19 

7-20 

7-21 

7-21 


COMPARE LOGICAL (character) 
COMPARE LOGICAL (immediate) 
COMPARE LOGICAL C. UNDER MASK 
COMPARE LOGICAL LONG 
CONVERT TO BINARY 


CLC 

CLI 

CLM 

CLCL 

CVB 


SS C 
SI C 
RS C 
RR C 
RX 


A 

A 

A 

A SP 

A 


II 

D IK 


R 
R 


D5 
95 
BD 
OF 
4F 


7-21 
7-21 
7-21 
7-22 
7-23 


CONVERT TO DECIMAL 

DIAGNOSE 

DIVIDE 

DIVIDE 

DIVIDE (extended) 


CVD 

DR 

D 

DXR 


RX 

DM 
RR 
RX 
RRE 


A 
P DM 

SP 

A SP 

SP 


IK 

IK 

EU EO FK 


ST 

R 
R 


4E 
83 
ID 
5D 
B22D 


7-24 
10-4 
7-24 
7-24 
9-8 
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Name 


Mne- 
monic 


Characteri st i cs 


Op 
Code 


Page 
No. 


DIVIDE (long) 
DIVIDE (long) 
DIVIDE (short) 
DIVIDE (short) 
DIVIDE DECIMAL 


DDR 

DD 

DER 

DE 

DP 


RR 
RX 
RR 
RX 
SS 


SP 
A SP 

SP 
A SP 
A SP 


EU EO FK 
EU EO FK 
EU EO FK 
EU EO FK 
D DK 


ST 


2D 
6D 
3D 
7D 
FD 


9-8 
9-8 
9-8 
9-8 
8-5 


EDIT 

EDIT AND MARK 

EXCLUSIVE OR 

EXCLUSIVE OR 

EXCLUSIVE OR (character) 


ED 

EDMK 

XR 

X 

XC 


SS C 
SS C 
RR C 
RX C 
SS C 


A 
A 

A 
A 


D 

D Gl 


ST 
R ST 
R 
R 

ST 


DE 
DF 
17 
57 
D7 


8-6 

8-9 

7-25 

7-25 

7-25 


EXCLUSIVE OR (immediate) 

EXECUTE 

EXTRACT PRIMARY ASN 

EXTRACT SECONDARY ASN 

HALT SUBCHANNEL 


XI 

EX 

EPAR 

ESAR 

HSCH 


SI C 
RX 
RRE 
RRE 
S C 


A 

AI SP 
Q 
Q 
P 


EX 

SO 
SO 
OP * GS 


ST 

R 
R 


97 

44 

B226 

B227 

B231 


7-25 
7-26 
10-5 
10-5 
14-4 


HALVE (long) 

HALVE (short) 

INSERT ADDRESS SPACE CONTROL 

INSERT CHARACTER 

INSERT CHARACTERS UNDER MASK 


HDR 
HER 
IAC 
IC 
I CM 


RR 
RR 

RRE C 
RX 
RS C 


SP 
SP 
Q 
A 
A 


EU 
EU 
SO 


R 
R 
R 


24 

34 

B224 

43 

BF 


9-10 
9-10 
10-6 
7-27 
7-27 


INSERT PROGRAM MASK 
INSERT PSW KEY 
INSERT STORAGE KEY EXTENDED 
INSERT VIRTUAL STORAGE KEY 
INVALIDATE PAGE TABLE ENTRY 


IPM 

IPK 

ISKE 

IVSK 

IPTE 


RRE 

S 

RRE 

RRE 

RRE 


Q 
P 

Q A 1 
P A 1 


G2 
SO 


R 
R 

R 


B222 
B20B 
B229 
B223 
B221 


7-27 
10-7 
10-7 
10-7 
10-8 


LOAD 

LOAD 

LOAD (long) 

LOAD (long) 

LOAD (short) 


LR 

L 

LDR 

LD 

LER 


RR 
RX 
RR 
RX 
RR 


A 

SP 
A SP 

SP 




R 
R 


18 
58 
28 
68 
38 


7-28 
7-28 
9-10 
9-10 
9-10 


LOAD (short) 

LOAD ADDRESS 

LOAD ADDRESS SPACE PARAMETERS 

LOAD AND TEST 

LOAD AND TEST (long) 


LE 

LA 

LASP 

LTR 

LTDR 


RX 
RX 

SSE C 
RR C 
RR C 


A SP 

P AS SP 

SP 


SO 


R 
R 


78 

41 

E500 

12 

22 


9-10 

7-28 

10-10 

7-28 

9-11 


LOAD AND TEST (short) 
LOAD COMPLEMENT 
LOAD COMPLEMENT (long) 
LOAD COMPLEMENT (short) 
LOAD CONTROL 


LTER 

LCR 

LCDR 

LCER 

LCTL 


RR C 
RR C 
RR C 
RR C 
RS 


SP 

SP 

SP 

P A SP 


IF 


R 


32 
13 
23 
33 

B7 


9-11 
7-28 
9-11 
9-11 
10-17 


LOAD HALFWORD 

LOAD MULTIPLE 

LOAD NEGATIVE 

LOAD NEGATIVE (long) 

LOAD NEGATIVE (short) 


LH 

LM 

LNR 

LNDR 

LNER 


RX 
RS 

RR C 
RR C 
RR C 


A 
A 

SP 
SP 




R 
R 
R 


48 
98 

11 
21 
31 


7-29 
7-29 
7-29 
9-11 
9-11 


LOAD POSITIVE 

LOAD POSITIVE (long) 

LOAD POSITIVE (short) 

LOAD PSW 

LOAD REAL ADDRESS 


LPR 

LPDR 

LPER 

LPSW 

LRA 


RR C 
RR C 
RR C 
S L 
RX C 


SP 
SP 

P A SP 

P A 1 


IF 


R 
R 


10 
20 
30 
82 
Bl 


7-30 

9-12 

9-12 

10-17 

10-18 


LOAD ROUNDED (ext. to long) 
LOAD ROUNDED (long to short) 
MODIFY SUBCHANNEL 
MONITOR CALL 
MOVE (character) 


i-RDR 

LRER 

MSCH 

MC 

MVC 


RR 
RR 

S C 
SI 
SS 


SP 

SP 

P A SP 

SP 

A 


EO 
EO 
OP * GS 
MO 


ST 


25 
35 
B232 

AF 
D2 


9-12 
9-12 
14-6 
7-30 
7-31 
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Name 


Mne- 
monic 


Characteri sties 


Op 
Code 


Page 
No. 


MOVE (immediate) 
MOVE INVERSE 
MOVE LONG 
MOVE NUMERICS 
MOVE TO PRIMARY 


MVI 

MVCIN 

MVCL 

MVN 

MVCP 


SI 

SS MI 

RR C 

SS 

SS C 


A 
A 

A SP 
A 
Q A 1 


II 

SO * 


ST 
ST 
R ST 
ST 
ST 


92 
E8 
OE 
Dl 
DA 


7-31 
7-31 
7-32 
7-35 
10-19 


MOVE TO SECONDARY 
MOVE WITH KEY 
MOVE WITH OFFSET 
MOVE ZONES 
MULTIPLY 


MVCS 

MVCK 

MVO 

MVZ 

MR 


SS C 
SS C 
SS 
SS 
RR 


Q A 1 
Q A 

A 

A 

SP 


SO <f 


ST 
ST 
ST 
ST 
R 


DB 
D9 
Fl 
D3 
1C 


10-19 

10-20 

7-35 

7-36 

7-36 


MULTIPLY 

MULTIPLY (extended) 
MULTIPLY (long to extended) 
MULTIPLY (long to extended) 
MULTIPLY (long) 


M 

MXR 

MXDR 

MXD 

MDR 


RX 
RR 
RR 
RX 
RR 


A SP 
SP 
SP 

A SP 
SP 


EU EO 
EU EO 
EU EO 
EU EO 


R 


5C 
26 
27 
67 
2C 


7-36 
9-13 
9-13 
9-13 
9-13 


MULTIPLY (long) 
MULTIPLY (short to long) 
MULTIPLY (short to long) 
MULTIPLY DECIMAL 
MULTIPLY HALFWORD 


MD 

MER 

ME 

MP 

MH 


RX 
RR 
RX 
SS 
RX 


A SP 
SP 
A SP 
A SP 
A 


EU EO 
EU EO 
EU EO 
D 


ST 
R 


6C 
3C 
7C 
FC 
4C 


9-13 
9-13 
9-13 
8-10 
7-37 


OR 

OR 

OR (character) 

OR (immediate) 

PACK 


OR 



OC 

01 

PACK 


RR C 
RX C 
SS C 
SI C 
SS 


A 
A 
A 
A 




R 

R 
ST 
ST 
ST 


16 
56 
D6 
96 
F2 


7-37 
7-37 
7-37 
7-37 
7-38 


PROGRAM CALL 

PROGRAM TRANSFER 

PURGE TLB 

RESET CHANNEL PATH 

RESET REFERENCE BIT EXTENDED 


PC 

PT 

PTLB 

RCHP 

RRBE 


S 

RRE 

S 

S C 

RRE C 


Q AT 

Q AT SP 

P 

P 

P A 1 


Z l T * GM 
Z 2 T * 
$ 
OP * Gl 


B R 
B 


B218 
B228 
B20D 
B23B 
B22A 


10-21 

10-28 

10-33 

14-7 

10-33 


RESUME SUBCHANNEL 

SET ADDRESS LIMIT 

SET ADDRESS SPACE CONTROL 

SET CHANNEL MONITOR 

SET CLOCK 


RSCH 

SAL 

SAC 

SCHM 

SCK 


S C 

S 

S 

S 

S C 


P 
P 

SP 
P 
P A SP 


OP * GS 
OP * Gl 
SO * 
OP $ GM 




B238 
B237 
B219 
B23C 
B204 


14-8 

14-9 

10-33 

14-10 

10-34 


SET CLOCK COMPARATOR 

SET CPU TIMER 

SET PREFIX 

SET PROGRAM MASK 

SET PSW KEY FROM ADDRESS 


SCKC 

SPT 

SPX 

SPM 

SPKA 


S 

S 

S 

RR L 

S 


P A SP 
P A SP 
P A SP 

Q 


$ 




B206 

B208 

B210 

04 

B20A 


10-35 

10-35 

10-36 

7-39 

10-36 


SET SECONDARY ASN 

SET STORAGE KEY EXTENDED 

SET SYSTEM MASK 

SHIFT AND ROUND DECIMAL 

SHIFT LEFT DOUBLE 


SSAR 

SSKE 

SSM 

SRP 

SLDA 


RRE 

RRE 

S 

SS C 

RS C 


AT 
P 
P A SP 

A 

SP 


Z 3 T * 

SO 

D DF 
IF 


ST 
R 


B225 

B22B 

80 

FO 

8F 


10-37 

10-40 

10-40 

8-10 

7-39 


SHIFT LEFT DOUBLE LOGICAL 

SHIFT LEFT SINGLE 

SHIFT LEFT SINGLE LOGICAL 

SHIFT RIGHT DOUBLE 

SHIFT RIGHT DOUBLE LOGICAL 


SLDL 

SLA 

SLL 

SRDA 

SRDL 


RS 

RS C 
RS 

RS C 
RS 


SP 

SP 
SP 


IF 


R 
R 
R 
R 
R 


8D 
8B 
89 
8E 
8C 


7-40 
7-40 
7-40 
7-41 
7-41 


SHIFT RIGHT SINGLE 

SHIFT RIGHT SINGLE LOGICAL 

SIGNAL PROCESSOR 

START SUBCHANNEL 

STORE 


SRA 

SRL 

SIGP 

SSCH 

ST 


RS C 
RS 

RS C 
S C 
RX 


P 

P A SP 
A 


$ 
OP $ GS 


R 
R 
R 

ST 


8A 

88 

AE 

B233 

50 


7-41 

7-42 

10-40 

14-12 

7-42 



Instructions Arranged by Name (Part 3 of 4) 



B-4 370-XA Principles of Operation 



Name 


Mne- 
tnoni c 


Characteri sties 


Op 
Code 


Page 
No. 


STORE (long) 

STORE (short) 

STORE CHANNEL PATH STATUS 

STORE CHANNEL REPORT WORD 

STORE CHARACTER 


STD 

STE 

STCPS 

STCRW 

STC 


RX 

RX 

S 

S C 

RX 


A SP 

A SP 

P A SP 

P A SP 

A 


$ 
* 


ST 
ST 
ST 
ST 
ST 


60 

70 

B23A 

B239 

42 


9-14 

9-14 

14-13 

14-14 

7-42 


STORE CHARACTERS UNDER MASK 

STORE CLOCK 

STORE CLOCK COMPARATOR 

STORE CONTROL 

STORE CPU ADDRESS 


STCM 

STCK 

STCKC 

STCTL 

STAP 


RS 

S C 
S 

RS 
S 


A 

A 
P A SP 
P A SP 
P A SP 


$ 


ST 
ST 
ST 
ST 
ST 


BE 

B205 

B207 

B6 

B212 


7-42 

7-43 

10-42 

10-42 

10-42 


STORE CPU ID 
STORE CPU TIMER 
STORE HALFWORD 
STORE MULTIPLE 
STORE PREFIX 


STIDP 

STPT 

STH 

STM 

STPX 


S 

S 

RX 

RS 

S 


P A SP 
P A SP 

A 

A 
P A SP 




ST 
ST 
ST 
ST 
ST 


B202 

B209 

40 

90 

B211 


10-42 

10-43 

7-44 

7-44 

10-43 


STORE SUBCHANNEL 

STORE THEN AND SYSTEM MASK 

STORE THEN OR SYSTEM MASK 

SUBTRACT 

SUBTRACT 


STSCH 

STNSM 

STOSM 

SR 

S 


S C 
SI 
SI 

RR C 
RX C 


P A SP 

P A 

P A SP 

A 


OP * GS 

IF 
IF 


ST 
ST 
ST 

R 

R 


B234 

AC 

AD 

IB 

5B 


14-14 

10-44 

10-44 

7-44 

7-44 


SUBTRACT DECIMAL 
SUBTRACT HALFWORD 
SUBTRACT LOGICAL 
SUBTRACT LOGICAL 
SUBTRACT NORMALIZED (ext.) 


SP 

SH 

SLR 

SL 

SXR 


SS C 
RX C 
RR C 
RX C 
RR C 


A 
A 

A 

SP 


D DF 
IF 

EU EO LS 


ST 
R 
R 
R 


FB 
4B 
IF 
5F 
37 


8-11 
7-45 
7-45 
7-45 
9-14 


SUBTRACT NORMALIZED (long) 
SUBTRACT NORMALIZED (long) 
SUBTRACT NORMALIZED (short) 
SUBTRACT NORMALIZED (short) 
SUBTRACT UNNORMALIZED (long) 


SDR 

SD 

SER 

SE 

SWR 


RR C 
RX C 
RR C 
RX C 
RR C 


SP 
A SP 

SP 
A SP 

SP 


EU EO LS 
EU EO LS 
EU EO LS 
EU EO LS 
EO LS 




2B 
6B 
3B 
7B 
2F 


9-14 
9-14 
9-14 
9-14 
9-15 


SUBTRACT UNNORMALIZED (long) 
SUBTRACT UNNORMALIZED (short) 
SUBTRACT UNNORMALIZED (short) 
SUPERVISOR CALL 
TEST AND SET 


SW 

SUR 

SU 

SVC 

TS 


RX C 
RR C 
RX C 
RR 
S C 


A SP 

SP 

A SP 

A 


EO LS 
EO LS 
EO LS 
« 


ST 


6F 
3F 
7F 
OA 
93 


9-15 
9-15 
9-15 
7-45 
7-46 


TEST BLOCK 

TEST PENDING INTERRUPTION 

TEST PROTECTION 

TEST SUBCHANNEL 

TEST UNDER MASK 


TB 

TPI 

TPROT 

TSCH 

TM 


RRE C 
S C 
SSE C 
S C 
SI C 


P A 1 
P A 1 SP 
P A 1 
P A SP 
A 


II $ GO 
OP $ GS 


R 
ST 

ST 


B22C 
B236 
E501 
B235 
91 


10-44 
14-15 
10-46 
14-16 
7-46 


TRACE 

TRANSLATE 

TRANSLATE AND TEST 

UNPACK 

UPDATE TREE 

ZERO AND ADD 


TRACE 

TR 

TRT 

UNPK 

UPT 

ZAP 


RS 
SS 

SS C 
SS 

E C 
SS C 


P A SP 
A 
A 
A 

A SP 
A 


T * 

GM 

II GM 
D DF 


ST 
R 

ST 
R ST 

ST 


99 

DC 

DD 

F3 

0102 

F8 


10-48 

7-47 

7-47 

7-48 

7-49 

8-12 



Instructions Arranged by Name (Part 4 of 4) 



Appendix B. Lists of Instructions B-5 



Mne- 
monic 


Name 


Characteri sties 


Op 
Code 


Page 
No. 


A 

AD 
ADR 
AE 


DIAGNOSE 

ADD 

ADD NORMALIZED (long) 

ADD NORMALIZED (long) 

ADD NORMALIZED (short) 


DM 
RX C 
RX C 
RR C 
RX C 


P DM 
A 

A SP 

SP 

A SP 


IF 
EU EO LS 
EU EO LS 
EU EO LS 


R 


83 
5A 
6A 
2A 
7A 


10-4 

7-8 

9-6 

9-6 

9-6 


AER 

AH 

AL 

ALR 

AP 


ADD NORMALIZED (short) 
ADD HALFWORD 
ADD LOGICAL 
ADD LOGICAL 
ADD DECIMAL 


RR C 
RX C 
RX C 
RR C 
SS C 


SP 
A 
A 

A 


EU EO LS 
IF 

D DF 


R 
R 
R 
ST 


3A 
4A 
5E 
IE 
FA 


9-6 
7-8 
7-9 
7-9 
8-5 


AR 

All 

AUR 

AU1 

AUR 


ADD 

ADD UNNORMALIZED (short) 
ADD UNNORMALIZED (short) 
ADD UNNORMALIZED (long) 
ADD UNNORMALIZED (long) 


RR C 
RX C 
RR C 
RX C 
RR C 


A SP 
SP 

A SP 
SP 


IF 

EO LS 
EO LS 
EO LS 
EO LS 


R 


1A 
7E 
3E 
6E 
2E 


7-8 
9-7 
9-7 
9-7 
9-7 


AXR 

BAL 

BALR 

BAS 

BASR 


ADD NORMALIZED (extended) 
BRANCH AND LINK 
BRANCH AND LINK 
BRANCH AND SAVE 
BRANCH AND SAVE 


RR C 

RX 

RR 

RX 

RR 


SP 


EU EO LS 

T 
T 


B R 
B R 
B R 
B R 


36 
45 
05 
4D 
0D 


9-6 

7-10 

7-10 

7-11 

7-11 


BASSM 

BC 

BCR 

BCT 

BCTR 


BRANCH AND SAVE AND SET MODE 
BRANCH ON CONDITION 
BRANCH ON CONDITION 
BRANCH ON COUNT 
BRANCH ON COUNT 


RR 
RX 
RR 
RX 
RR 




T 


B R 
B 
B 

B R 
B R 


OC 
47 
07 
46 
06 


7-11 
7-12 
7-12 
7-13 
7-13 


BSM 

BXH 

BXLE 

C 

CD 


BRANCH AND SET MODE 

BRANCH ON INDEX HIGH 

BRANCH ON INDEX LOW OR EQUAL 

COMPARE 

COMPARE (long) 


RR 
RS 
RS 

RX C 
RX C 


A 

A SP 




B R 
B R 
B R 


OB 
86 
87 
59 
69 


7-12 
7-13 
7-14 
7-14 
9-8 


CDR 

CDS 

CE 

CER 

CFC 


COMPARE (long) 

COMPARE DOUBLE AND SWAP 

COMPARE (short) 

COMPARE (short) 

COMPARE AND FORM CODEWORD 


RR C 
RS C 
RX C 
RR C 
S C 


SP 
A SP 
A SP 

SP 
A SP 


$ 
II GM 


R ST 
R 


29 
BB 
79 
39 
B21A 


9-8 

7-19 

9-8 

9-8 

7-15 


CH 

CL 

CLC 

CLCL 

CLI 


COMPARE HALFWORD 

COMPARE LOGICAL 

COMPARE LOGICAL (character) 

COMPARE LOGICAL LONG 

COMPARE LOGICAL (immediate) 


RX C 
RX C 
SS C 
RR C 
SI C 


A 

A 

A 

A SP 

A 


II 


R 


49 
55 
D5 
OF 
95 


7-20 
7-21 
7-21 
7-22 
7-21 


CLM 

CLR 

CP 

CR 

CS 


COMPARE LOGICAL C. UNDER MASK 

COMPARE LOGICAL 

COMPARE DECIMAL 

COMPARE 

COMPARE AND SWAP 


RS C 
RR C 
SS C 
RR C 
RS C 


A 
A 
A SP 


D 

$ 


R ST 


BD 
15 
F9 
19 
BA 


7-21 

7-21 

8-5 

7-14 

7-19 


CSCH 

CVB 

CVD 

D 

DD 


CLEAR SUBCHANNEL 
CONVERT TO BINARY 
CONVERT TO DECIMAL 
DIVIDE 
DIVIDE (long) 


S C 

RX 

RX 

RX 

RX 


P 
A 
A 

A SP 
A SP 


OP * GS 
D IK 

IK 
EU EO FK 


R 

ST 
R 


B230 

4F 

4E 

5D 

6D 


14-3 
7-23 
7-24 
7-24 
9-8 


DDR 

DE 

DER 

DP 

DR 


DIVIDE (long) 
DIVIDE (short) 
DIVIDE (short) 
DIVIDE DECIMAL 
DIVIDE 


RR 
RX 
RR 
SS 
RR 


SP 
A SP 

SP 
A SP 

SP 


EU EO FK 
EU EO FK 
EU EO FK 
D DK 
IK 


ST 
R 


2D 
7D 
3D 
FD 
ID 


9-8 
9-8 
9-8 
8-5 
7-24 



Instructions Arranged by Mnemonic (Part 1 of 4) 



B-6 370-XA Principles of Operation 



Mne- 
moni c 


Name 


Character! sti cs 


Op 
Code 


Page 
No. 


DXR 

ED 

EDMK 

EPAR 

ESAR 


DIVIDE (extended) 

EDIT 

EDIT AND MARK 

EXTRACT PRIMARY ASN 

EXTRACT SECONDARY ASN 


RRE 
SS C 
SS C 
RRE 
RRE 


SP 

A 

A 
Q 
Q 


EU EO FK 

D 

D Gl 

SO 

SO 


ST 
R ST 
R 
R 


B22D 

DE 

DF 

B226 

B227 


9-8 

8-6 

8-9 

10-5 

10-5 


EX 

HDR 

HER 

HSCH 

IAC 


EXECUTE 

HALVE (long) 

HALVE (short) 

HALT SUBCHANNEL 

INSERT ADDRESS SPACE CONTROL 


RX 
RR 
RR 

S C 
RRE C 


AI SP 
SP 
SP 

P 

Q 


EX 
EU 
EU 

OP « GS 
SO 


R 


44 

24 

34 

B231 

B224 


7-26 
9-10 
9-10 
14-4 
10-6 


IC 

ICM 

IPK 

IPM 

IPTE 


INSERT CHARACTER 

INSERT CHARACTERS UNDER MASK 

INSERT PSW KEY 

INSERT PROGRAM MASK 

INVALIDATE PAGE TABLE ENTRY 


RX 

RS C 
S 

RRE 
RRE 


A 
A 
Q 

P A 1 


G2 
$ 


R 
R 
R 
R 


43 

BF 

B20B 

B222 

B221 


7-27 
7-27 
10-7 
7-27 
10-8 


ISKE 

IVSK 

L 

LA 

LASP 


INSERT STORAGE KEY EXTENDED 

INSERT VIRTUAL STORAGE KEY 

LOAD 

LOAD ADDRESS 

LOAD ADDRESS SPACE PARAMETERS 


RRE 
RRE 
RX 
RX 
SSE C 


P 

Q A 1 
A 

P AS SP 


SO 
SO 


R 
R 
R 


B229 

B223 

58 

41 

E500 


10-7 
10-7 
7-28 
7-28 
10-10 


LCDR 

LCER 

LCR 

LCTL 

LD 


LOAD COMPLEMENT (long) 
LOAD COMPLEMENT (short) 
LOAD COMPLEMENT 
LOAD CONTROL 
LOAD (long) 


RR C 
RR C 
RR C 
RS 
RX 


SP 
SP 

P A SP 
A SP 


IF 


R 


23 
33 
13 
B7 
68 


9-11 

9-11 

7-28 

10-17 

9-10 


LDR 

LE 

LER 

LH 

LM 


LOAD (long) 
LOAD (short) 
LOAD (short) 
LOAD HALFWORD 
LOAD MULTIPLE 


RR 
RX 
RR 
RX 
RS 


SP 
A SP 

SP 
A 
A 




R 
R 


28 
78 
38 
48 
98 


9-10 
9-10 
9-10 
7-29 
7-29 


LNDR 

LNER 

LNR 

LPDR 

LPER 


LOAD NEGATIVE (long) 
LOAD NEGATIVE (short) 
LOAD NEGATIVE 
LOAD POSITIVE (long) 
LOAD POSITIVE (short) 


RR C 
RR C 
RR C 
RR C 
RR C 


SP 
SP 

SP 
SP 




R 


21 
31 
11 
20 
30 


9-11 
9-11 
7-29 
9-12 
9-12 


LPR 

LPSW 

LR 

LRA 

LRDR 


LOAD POSITIVE 

LOAD PSW 

LOAD 

LOAD REAL ADDRESS 

LOAD ROUNDED (ext. to long) 


RR C 
S L 
RR 
RX C 

RR 


P A SP 

P A 1 

SP 


IF 
EO 


R 

R 
R 


10 
82 
18 
Bl 
25 


7-30 

10-17 

7-28 

10-18 

9-12 


LRER 

LTDR 

LTER 

LTR 

M 


LOAD ROUNDED (long to short) 

LOAD AND TEST (long) 

LOAD AND TEST (short) 

LOAD AND TEST 

MULTIPLY 


RR 

RR C 
RR C 
RR C 
RX 


SP 
SP 
SP 

A SP 


EO 


R 
R 


35 
22 
32 
12 
5C 


9-12 
9-11 
9-11 
7-28 
7-36 


MC 

MD 

MDR 

ME 

MER 


MONITOR CALL 
MULTIPLY (long) 
MULTIPLY (long) 
MULTIPLY (short to long) 
MULTIPLY (short to long) 


SI 
RX 
RR 
RX 
RR 


SP 
A SP 

SP 
A SP 

SP 


MO 
EU EO 
EU EO 
EU EO 
EU EO 




AF 
6C 
2C 
7C 
3C 


7-30 
9-13 
9-13 
9-13 
9-13 


MH 

MP 

MR 

MSCH 

MVC 


MULTIPLY HALFWORD 
MULTIPLY DECIMAL 
MULTIPLY 

MODIFY SUBCHANNEL 
MOVE (character) 


RX 
SS 
RR 

S C 
SS 


A 

A SP 
SP 
P A SP 
A 


D 

OP * GS 


R 

ST 
R 

ST 


4C 

FC 

IC 

B232 

D2 


7-37 
8-10 
7-36 
14-6 
7-31 



Instructions Arranged by Mnemonic (Part 2 of 4) 



Appendix B. Lists of Instructions B-7 



Mne- 
moni c 


Name 


Characteri sties 


Op 
Code 


Page 
No. 


MVCIN 

MVCK 

MVCL 

MVCP 

MVCS 


MOVE INVERSE 
MOVE WITH KEY 
MOVE LONG 
MOVE TO PRIMARY 
MOVE TO SECONDARY 


SS MI 
SS C 
RR C 
SS C 
SS C 


A 
Q A 

A SP 
Q A 1 
Q A 1 


II 

SO * 

SO * 


ST 
ST 
R ST 
ST 
ST 


E8 
D9 
OE 
DA 
DB 


7-31 

10-20 

7-32 

10-19 

10-19 


MVI 
MVN 
MVO 
MVZ 
MXD 


MOVE (immediate) 

MOVE NUMERICS 

MOVE WITH OFFSET 

MOVE ZONES 

MULTIPLY (long to extended) 


SI 
SS 
SS 
SS 
RX 


A 
A 
A 
A 
A SP 


EU EO 


ST 
ST 
ST 
ST 


92 
Dl 
Fl 
D3 
67 


7-31 
7-35 
7-35 
7-36 
9-13 


MXDR 

MXR 

N 

NC 

NI 


MULTIPLY (long to extended) 

MULTIPLY (extended) 

AND 

AND (character) 

AND (immediate) 


RR 
RR 

RX C 
SS C 
SI C 


SP 
SP 

A 

A 

A 


EU EO 
EU EO 


R 
ST 
ST 


27 
25 
54 
D4 
94 


9-13 

9-13 

7-9 

7-9 

7-9 


NR 



OC 

01 

OR 


AND 

OR 

OR (character) 

OR (immediate) 

OR 


RR C 
RX C 
SS C 
SI C 
RR C 


A 
A 
A 




R 

R 
ST 
ST 

R 


14 
56 
D6 
96 
16 


7-9 

7-37 

7-37 

7-37 

7-37 


PACK 

PC 

PT 

PTLB 

RCHP 


PACK 

PROGRAM CALL 

PROGRAM TRANSFER 

PURGE TLB 

RESET CHANNEL PATH 


SS 

S 

RRE 

S 

S C 


A 
Q AT 
Q AT SP 
P 
P 


Z l T * GM 
Z 2 T $ 
$ 
OP $ Gl 


ST 
B R 
B 


F2 

B218 

B228 

B20D 

B23B 


7-38 

10-21 

10-28 

10-33 

14-7 


RRBE 

RSCH 

S 

SAC 

SAL 


RESET REFERENCE BIT EXTENDED 

RESUME SUBCHANNEL 

SUBTRACT 

SET ADDRESS SPACE CONTROL 

SET ADDRESS LIMIT 


RRE C 
S C 
RX C 
S 
S 


P A 1 
P 
A 

SP 
P 


OP * GS 

IF 
SO * 
OP $ Gl 


R 


B22A 

B238 

5B 

B219 

B237 


10-33 

14-8 

7-44 

10-33 

14-9 


SCHM 

SCK 

SCKC 

SD 

SDR 


SET CHANNEL MONITOR 

SET CLOCK 

SET CLOCK COMPARATOR 

SUBTRACT NORMALIZED (long) 

SUBTRACT NORMALIZED (long) 


S 

S C 

S 

RX C 

RR C 


P 

P A SP 

P A SP 

A SP 

SP 


OP * GM 

EU EO LS 
EU EO LS 




B23C 

B204 

B206 

6B 

2B 


14-10 

10-34 

10-35 

9-14 

9-14 


SE 

SER 

SH 

SIGP 

SL 


SUBTRACT NORMALIZED (short) 
SUBTRACT NORMALIZED (short) 
SUBTRACT HALFWORD 
SIGNAL PROCESSOR 
SUBTRACT LOGICAL 


RX C 
RR C 
RX C 
RS C 
RX C 


A SP 
SP 
A 
P 
A 


EU EO LS 
EU EO LS 
IF 
$ 


R 
R 
R 


7B 
3B 
4B 
AE 
5F 


9-14 

9-14 

7-45 

10-40 

7-45 


SLA 

SLDA 

SLDL 

SLL 

SLR 


SHIFT LEFT SINGLE 
SHIFT LEFT DOUBLE 
SHIFT LEFT DOUBLE LOGICAL 
SHIFT LEFT SINGLE LOGICAL 
SUBTRACT LOGICAL 


RS C 
RS C 
RS 
RS 
RR C 


SP 
SP 


IF 
IF 


R 
R 
R 
R 
R 


8B 
8F 
8D 
89 
IF 


7-40 
7-39 
7-40 
7-40 
7-45 


SP 

SPKA 

SPM 

SPT 

SPX 


SUBTRACT DECIMAL 

SET PSW KEY FROM ADDRESS 

SET PROGRAM MASK 

SET CPU TIMER 

SET PREFIX 


SS C 

S 

RR L 

S 

S 


A 
Q 

P A SP 
P A SP 


D DF 

$ 


ST 


FB 

B20A 

04 

B208 

B210 


8-11 

10-36 

7-39 

10-35 

10-36 


SR 

SRA 

SRDA 

SRDL 

SRL 


SUBTRACT 

SHIFT RIGHT SINGLE 

SHIFT RIGHT DOUBLE 

SHIFT RIGHT DOUBLE LOGICAL 

SHIFT RIGHT SINGLE LOGICAL 


RR C 
RS C 
RS C 
RS 
RS 


SP 
SP 


IF 


R 
R 
R 
R 
R 


IB 
8A 
8E 
8C 
88 


7-44 
7-41 
7-41 
7-41 
7-42 



Instructions Arranged by Mnemonic (Part 3 of 4) 



B-8 370-XA Principles of Operation 



Mne- 
moni c 


Name 


Character! sties 


Op 
Code 


Page 
No. 


SRP 

SSAR 

SSCH 

SSKE 

SSM 


SHIFT AND ROUND DECIMAL 
SET SECONDARY ASN 
START SUBCHANNEL 
SET STORAGE KEY EXTENDED 
SET SYSTEM MASK 


SS C 
RRE 
S C 
RRE 
S 


A 

AT 
P A SP 
P 
P A SP 


D DF 

Z 3 T $ 

OP * GS 

SO 


ST 


FO 

B225 

B233 

B22B 

80 


8-10 

10-37 

14-12 

10-40 

10-40 


ST 

STAP 

STC 

STCK 

STCKC 


STORE 

STORE CPU ADDRESS 

STORE CHARACTER 

STORE CLOCK 

STORE CLOCK COMPARATOR 


RX 
S 

RX 

S C 
S 


A 
P A SP 

A 

A 
P A SP 


$ 


ST 
ST 
ST 
ST 
ST 


50 

B212 

42 

B205 

B207 


7-42 

10-42 

7-42 

7-43 

10-42 


STCM 

STCPS 

STCRW 

STCTL 

STD 


STORE CHARACTERS UNDER MASK 
STORE CHANNEL PATH STATUS 
STORE CHANNEL REPORT WORD 
STORE CONTROL 
STORE (long) 


RS 

S 

S C 

RS 

RX 


A 
P A SP 
P A SP 
P A SP 

A SP 


* 


ST 
ST 
ST 
ST 
ST 


BE 

B23A 

B239 

B6 

60 


7-42 

14-13 

14-14 

10-42 

9-14 


STE 

STH 

STIDP 

STM 

STNSM 


STORE (short) 

STORE HALFWORD 

STORE CPU ID 

STORE MULTIPLE 

STORE THEN AND SYSTEM MASK 


RX 

RX 

S 

RS 

SI 


A SP 

A 
P A SP 

A 
P A 




ST 
ST 
ST 
ST 
ST 


70 

40 

B202 

90 

AC 


9-14 

7-44 

10-42 

7-44 

10-44 


STCSM 

STPT 

STPX 

STSCH 

SU 


STORE THEN OR SYSTEM MASK 

STORE CPU TIMER 

STORE PREFIX 

STORE SUBCHANNEL 

SUBTRACT UNNORMALIZED (short) 


SI 

S 

S 

S C 

RX C 


P A SP 
P A SP 
P A SP 
P A SP 
A SP 


OP * GS 
EO LS 


ST 
ST 
ST 
ST 


AD 

B209 

B211 

B234 

7F 


10-44 
10-43 
10-43 
14-14 
9-15 


SUR 

SVC 

SU 

SUR 

SXR 


SUBTRACT UNNORMALIZED (short) 
SUPERVISOR CALL 
SUBTRACT UNNORMALIZED (long) 
SUBTRACT UNNORMALIZED (long) 
SUBTRACT NORMALIZED (ext.) 


RR C 
RR 

RX C 
RR C 
RR C 


SP 

A SP 
SP 
SP 


EO LS 

EO LS 

EO LS 

EU EO LS 




3F 
OA 
6F 
2F 
37 


9-15 
7-45 
9-15 
9-15 
9-14 


TB 

TM 

TPI 

TPROT 

TR 


TEST BLOCK 

TEST UNDER MASK 

TEST PENDING INTERRUPTION 

TEST PROTECTION 

TRANSLATE 


RRE C 
SI C 
S C 
SSE C 
SS 


P A 1 

A 
P A 1 SP 
P A 1 

A 


II $ GO 


R 
ST 
ST 


B22C 

91 

B236 

E501 

DC 


10-44 

7-46 

14-15 

10-46 

7-47 


TRACE 

TRT 

TS 

TSCH 

UNPK 


TRACE 

TRANSLATE AND TEST 

TEST AND SET 

TEST SUBCHANNEL 

UNPACK 


RS 

SS C 
S C 
S C 
SS 


P A SP 

A 

A 
P A SP 

A 


T * 

GM 
$ 
OP * GS 


R 
ST 
ST 
ST 


99 

DD 

93 

B235 

F3 


10-48 

7-47 

7-46 

14-16 

7-48 


UPT 

X 

XC 

XI 

XR 

ZAP 


UPDATE TREE 

EXCLUSIVE OR 

EXCLUSIVE OR (character) 

EXCLUSIVE OR (immediate) 

EXCLUSIVE OR 

ZERO AND ADD 


E C 
RX C 
SS C 
SI C 
RR C 
SS C 


A SP 
A 
A 
A 

A 


II GM 
D DF 


R ST 

R 
ST 
ST 

R 
ST 


0102 

57 

D7 

97 

17 

F8 


7-49 
7-25 
7-25 
7-25 
7-25 
8-12 
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Op 
Code 


Name 


Mne- 
monic 


Character! st i cs 


Page 
No. 


0102 

04 

05 

06 

07 


UPDATE TREE 
SET PROGRAM MASK 
BRANCH AND LINK 
BRANCH ON COUNT 
BRANCH ON CONDITION 


UPT 

SPM 

BALR 

BCTR 

BCR 


E C 
RR L 
RR 
RR 
RR 


A SP 


II GM 

T 


R ST 

B R 
B R 
B 


7-49 
7-39 
7-10 
7-13 
7-12 


0A 
OB 
OC 
OD 
OE 


SUPERVISOR CALL 

BRANCH AND SET MODE 

BRANCH AND SAVE AND SET MODE 

BRANCH AND SAVE 

MOVE LONG 


SVC 

BSM 

BASSM 

BASR 

MVCL 


RR 
RR 
RR 
RR 
RR C 


A SP 


T 
T 
II 


B R 
B R 
B R 
R ST 


7-45 
7-12 
7-11 
7-11 
7-32 


OF 
10 
11 
12 
13 


COMPARE LOGICAL LONG 
LOAD POSITIVE 
LOAD NEGATIVE 
LOAD AND TEST 
LOAD COMPLEMENT 


CLCL 

LPR 

LNR 

LTR 

LCR 


RR C 
RR C 
RR C 
RR C 
RR C 


A SP 


II 
IF 

IF 


R 

R 
R 
R 
R 


7-22 
7-30 
7-29 
7-28 
7-28 


14 
15 
16 
17 
18 


AND 

COMPARE LOGICAL 

OR 

EXCLUSIVE OR 

LOAD 


NR 

CLR 

OR 

XR 

LR 


RR C 
RR C 
RR C 
RR C 
RR 






R 

R 
R 
R 


7-9 

7-21 

7-37 

7-25 

7-28 


19 
1A 
IB 
1C 
ID 


COMPARE 

ADD 

SUBTRACT 

MULTIPLY 

DIVIDE 


CR 
AR 
SR 
MR 
DR 


RR C 
RR C 
RR C 
RR 
RR 


SP 
SP 


IF 
IF 

IK 


R 
R 
R 
R 


7-14 

7-8 

7-44 

7-36 

7-24 


IE 
IF 
20 
21 
22 


ADD LOGICAL 
SUBTRACT LOGICAL 
LOAD POSITIVE (long) 
LOAD NEGATIVE (long) 
LOAD AND TEST (long) 


ALR 

SLR 

LPDR 

LNDR 

LTDR 


RR C 
RR C 
RR C 
RR C 
RR C 


SP 
SP 
SP 




R 
R 


7-9 

7-45 

9-12 

9-11 

9-11 


23 
24 
25 
26 
27 


LOAD COMPLEMENT (long) 
HALVE (long) 

LOAD ROUNDED (ext. to long) 
MULTIPLY (extended) 
MULTIPLY (long to extended) 


LCDR 

HDR 

LRDR 

MXR 

MXDR 


RR C 

RR 

RR 

RR 

RR 


SP 
SP 
SP 
SP 
SP 


EU 

EO 
EU EO 
EU EO 




9-11 
9-10 
9-12 
9-13 
9-13 


28 
29 
2A 
2B 
2C 


LOAD (long) 

COMPARE (long) 

ADD NORMALIZED (long) 

SUBTRACT NORMALIZED (long) 

MULTIPLY (long) 


LDR 
CDR 
ADR 
SDR 
MDR 


RR 

RR C 
RR C 
RR C 
RR 


SP 
SP 
SP 
SP 
SP 


EU EO LS 
EU EO LS 
EU EO 




9-10 

9-8 

9-6 

9-14 

9-13 


2D 
2E 
2F 
30 
31 


DIVIDE (long) 
ADD UNNORMALIZED (long) 
SUBTRACT UNNORMALIZED (long) 
LOAD POSITIVE (short) 
LOAD NEGATIVE (short) 


DDR 

AWR 

SWR 

LPER 

LNER 


RR 

RR C 
RR C 
RR C 
RR C 


SP 
SP 
SP 
SP 
SP 


EU EO FK 
EO LS 
EO LS 




9-8 

9-7 

9-15 

9-12 

9-11 


32 
33 
34 
35 
36 


LOAD AND TEST (short) 

LOAD COMPLEMENT (short) 

HALVE (short) 

LOAD ROUNDED (long to short) 

ADD NORMALIZED (extended) 


LTER 

LCER 

HER 

LRER 

AXR 


RR C 
RR C 
RR 
RR 
RR C 


SP 
SP 
SP 
SP 
SP 


EU 

EO 
EU EO LS 




9-11 
9-11 
9-10 
9-12 
9-6 


37 
38 
39 
3A 
3B 


SUBTRACT NORMALIZED (ext.) 

LOAD (short) 

COMPARE (short) 

ADD NORMALIZED (short) 

SUBTRACT NORMALIZED (short) 


SXR 
LER 
CER 
AER 
SER 


RR C 
RR 

RR C 
RR C 
RR C 


SP 
SP 
SP 
SP 
SP 


EU EO LS 

EU EO LS 
EU EO LS 




9-14 

9-10 

9-8 

9-6 

9-14 
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Op 
Code 


Name 


Mne- 
monic 


Characteri sti cs 


Page 
No. 


3C 
3D 
3E 
3F 
40 


MULTIPLY (short to long) 
DIVIDE (short) 
ADD UNNORMALIZED (short) 
SUBTRACT UNNORMALIZED (short) 
STORE HALFWORD 


MER 
DER 
AUR 
SUR 
STH 


RR 
RR 

RR C 
RR C 
RX 


SP 
SP 
SP 
SP 
A 


EU EO 

EU EO FK 
EO LS 
EO LS 


ST 


9-13 

9-8 

9-7 

9-15 

7-44 


41 
42 
43 
44 
45 


LOAD ADDRESS 

STORE CHARACTER 

INSERT CHARACTER 

EXECUTE 

BRANCH AND LINK 


LA 

STC 

IC 

EX 

BAL 


RX 
RX 
RX 
RX 
RX 


A 
A 
AI SP 


EX 


R 

ST 
R 

B R 


7-28 
7-42 
7-27 
7-26 
7-10 


46 
47 
48 
49 
4A 


BRANCH ON COUNT 
BRANCH ON CONDITION 
LOAD HALFWORD 
COMPARE HALFWORD 
ADD HALFWORD 


BCT 

BC 

LH 

CH 

AH 


RX 
RX 
RX 

RX C 
RX C 


A 
A 
A 


IF 


B R 
B 
R 

R 


7-13 
7-12 
7-29 
7-20 
7-8 


4B 
4C 
4D 
4E 
4F 


SUBTRACT HALFWORD 
MULTIPLY HALFWORD 
BRANCH AND SAVE 
CONVERT TO DECIMAL 
CONVERT TO BINARY 


SH 

MH 

BAS 

CVD 

CVB 


RX C 

RX 

RX 

RX 

RX 


A 
A 

A 
A 


IF 
D IK 


R 

R 

B R 

ST 
R 


7-45 
7-37 
7-11 
7-24 
7-23 


50 
54 
55 
56 
57 


STORE 

AND 

COMPARE LOGICAL 

OR 

EXCLUSIVE OR 


ST 

N 

CL 

O 

X 


RX 

RX C 
RX C 
RX C 
RX C 


A 
A 
A 
A 
A 




ST 
R 

R 
R 


7-42 

7-9 

7-21 

7-37 

7-25 


58 
59 
5A 
5B 
5C 


LOAD 

COMPARE 

ADD 

SUBTRACT 

MULTIPLY 


L 
C 
A 
S 

M 


RX 

RX C 
RX C 
RX C 
RX 


A 
A 
A 
A 
A SP 


IF 
IF 


R 

R 
R 
R 


7-28 

7-14 

7-8 

7-44 

7-36 


5D 
5E 
5F 
60 
67 


DIVIDE 

ADD LOGICAL 

SUBTRACT LOGICAL 

STORE (long) 

MULTIPLY (long to extended) 


D 

AL 

SL 

STD 

MXD 


RX 

RX C 
RX C 
RX 
RX 


A SP 

A 

A 

A SP 

A SP 


IK 
EU EO 


R 
R 
R 
ST 


7-24 

7-9 

7-45 

9-14 

9-13 


68 
69 
6A 
6B 
6C 


LOAD (long) 

COMPARE (long) 

ADD NORMALIZED (long) 

SUBTRACT NORMALIZED (long) 

MULTIPLY (long) 


LD 
CD 
AD 
SD 
MD 


RX 

RX C 
RX C 
RX C 
RX 


A SP 
A SP 
A SP 
A SP 
A SP 


EU EO LS 
EU EO LS 
EU EO 




9-10 

9-8 

9-6 

9-14 

9-13 


6D 
6E 
6F 
70 
78 


DIVIDE (long) 

ADD UNNORMALIZED (long) 

SUBTRACT UNNORMALIZED (long) 

STORE (short) 

LOAD (short) 


DD 

AW 

SW 

STE 

LE 


RX 

RX C 
RX C 
RX 
RX 


A SP 
A SP 
A SP 
A SP 
A SP 


EU EO FK 
EO LS 
EO LS 


ST 


9-8 

9-7 

9-15 

9-14 

9-10 


79 
7A 
7B 
7C 
7D 


COMPARE (short) 
ADD NORMALIZED (short) 
SUBTRACT NORMALIZED (short) 
MULTIPLY (short to long) 
DIVIDE (short) 


CE 
AE 
SE 
ME 
DE 


RX C 
RX C 
RX C 
RX 
RX 


A SP 
A SP 
A SP 
A SP 
A SP 


EU EO LS 
EU EO LS 
EU EO 
EU EO FK 




9-8 

9-6 

9-14 

9-13 

9-8 


7E 
7F 
80 
82 
83 


ADD UNNORMALIZED (short) 
SUBTRACT UNNORMALIZED (short) 
SET SYSTEM MASK 
LOAD PSW 
DIAGNOSE 


AU 
SU 
SSM 
LPSW 


RX C 
RX C 
S 

S L 
DM 


A SP 

A SP 

P A SP 

P A SP 

P DM 


EO LS 
EO LS 
SO 




9-7 

9-15 

10-40 

10-17 

10-4 
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Mne- 
moni c 


Characteri sti cs 


Page 
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86 
87 
88 
89 
8A 


BRANCH ON INDEX HIGH 
BRANCH ON INDEX LOW OR EQUAL 
SHIFT RIGHT SINGLE LOGICAL 
SHIFT LEFT SINGLE LOGICAL 
SHIFT RIGHT SINGLE 


BXH 

BXLE 

SRL 

SLL 

SRA 


RS 
RS 
RS 
RS 
RS C 






B R 

B R 

R 

R 

R 


7-13 
7-14 
7-42 
7-40 
7-41 


8B 
8C 
8D 
8E 
8F 


SHIFT LEFT SINGLE 
SHIFT RIGHT DOUBLE LOGICAL 
SHIFT LEFT DOUBLE LOGICAL 
SHIFT RIGHT DOUBLE 
SHIFT LEFT DOUBLE 


SLA 

SRDL 

SLDL 

SRDA 

SLDA 


RS C 
RS 
RS 

RS C 
RS C 


SP 
SP 
SP 
SP 


IF 
IF 


R 
R 
R 
R 
R 


7-40 
7-41 
7-40 
7-41 
7-39 


90 
91 
92 
93 
94 


STORE MULTIPLE 
TEST UNDER MASK 
MOVE (immediate) 
TEST AND SET 
AND (immediate) 


STM 

TM 

MVI 

TS 

NI 


RS 

SI C 
SI 

S C 
SI C 


A 
A 
A 
A 
A 


$ 


ST 

ST 
ST 
ST 


7-44 
7-46 
7-31 
7-46 
7-9 


95 
96 
97 
98 
99 


COMPARE LOGICAL (immediate) 
OR (immediate) 
EXCLUSIVE OR (immediate) 
LOAD MULTIPLE 
TRACE 


CLI 

01 

XI 

LM 

TRACE 


SI C 
SI C 
SI C 
RS 
RS 


A 
A 
A 
A 
P A SP 


T « 


ST 
ST 
R 


7-21 
7-37 
7-25 
7-29 
10-48 


AC 
AD 
AE 
AF 
Bl 


STORE THEN AND SYSTEM MASK 
STORE THEN OR SYSTEM MASK 
SIGNAL PROCESSOR 
MONITOR CALL 
LOAD REAL ADDRESS 


STNSM 

STOSM 

SIGP 

MC 

LRA 


SI 
SI 

RS C 
SI 
RX C 


P A 

P A SP 

P 

SP 
P A 1 


$ 

MO 


ST 
ST 
R 

R 


10-44 

10-44 

10-40 

7-30 

10-18 


B202 
B204 
B205 
B206 
B207 


STORE CPU ID 

SET CLOCK 

STORE CLOCK 

SET CLOCK COMPARATOR 

STORE CLOCK COMPARATOR 


STIDP 

SCK 

STCK 

SCKC 

STCKC 


S 

S C 

S C 

S 

S 


P A SP 
P A SP 

A 
P A SP 
P A SP 


$ 


ST 
ST 
ST 


10-42 

10-34 

7-43 

10-35 

10-42 


B208 
B209 
B20A 
B20B 
B20D 


SET CPU TIMER 

STORE CPU TIMER 

SET PSW KEY FROM ADDRESS 

INSERT PSW KEY 

PURGE TLB 


SPT 

STPT 

SPKA 

IPK 

PTLB 


S 
S 
S 
S 
S 


P A SP 

P A SP 

Q 

Q 

P 


G2 


ST 
R 


10-35 

10-43 

10-36 

10-7 

10-33 


B210 
B211 
B212 
B218 
B219 


SET PREFIX 

STORE PREFIX 

STORE CPU ADDRESS 

PROGRAM CALL 

SET ADDRESS SPACE CONTROL 


SPX 

STPX 

STAP 

PC 

SAC 


s 
s 
s 
s 
s 


P A SP 
P A SP 
P A SP 
Q AT 

SP 


$ 

Z 1 T * GM 
SO * 


ST 
ST 
B R 


10-36 
10-43 
10-42 
10-21 
10-33 


B21A 
B221 
B222 
B223 
B224 


COMPARE AND FORM CODEWORD 
INVALIDATE PAGE TABLE ENTRY 
INSERT PROGRAM MASK 
INSERT VIRTUAL STORAGE KEY 
INSERT ADDRESS SPACE CONTROL 


CFC 

IPTE 

IPM 

IVSK 

IAC 


s c 

RRE 
RRE 
RRE 
RRE C 


A SP 
P A 1 

Q A 1 
Q 


II GM 
$ 

SO 
SO 


R 

R 
R 
R 


7-15 
10-8 
7-27 
10-7 
10-6 


B225 
B226 
B227 
B228 
B229 


SET SECONDARY ASN 

EXTRACT PRIMARY ASN 

EXTRACT SECONDARY ASN 

PROGRAM TRANSFER 

INSERT STORAGE KEY EXTENDED 


SSAR 

EPAR 

ESAR 

PT 

ISKE 


RRE 
RRE 
RRE 
RRE 
RRE 


AT 
Q 
Q 

Q AT SP 
P 


Z 3 T * 

SO 

SO 

Z 2 T * 


R 
R 
B 


10-37 

10-5 

10-5 

10-28 

10-7 


B22A 
B22B 
B22C 
B22D 
B230 


RESET REFERENCE BIT EXTENDED 
SET STORAGE KEY EXTENDED 
TEST BLOCK 
DIVIDE (extended) 
CLEAR SUBCHANNEL 


RRBE 

SSKE 

TB 

DXR 

CSCH 


RRE C 
RRE 
RRE C 
RRE 
s C 


P A 1 
P 
P A 1 

SP 
P 


II $ GO 
EU EO FK 
OP « GS 


R 


10-33 

10-40 

10-44 

9-8 

14-3 
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Op 




Mne- 


















Page 


Code 


Name 


moni c 






Chai 


-acteri 


sti cs 






No. 


B231 


HALT SUBCHANNEL 


HSCH 


S 


C 


p 






OP 


$ 


GS 




14-4 


B232 


MODIFY SUBCHANNEL 


MSCH 


S 


c 


p 


A 


SP 


OP 


<> 


GS 




14-6 


B233 


START SUBCHANNEL 


SSCH 


S 


c 


p 


A 


SP 


OP 


<f 


GS 




14-12 


B234 


STORE SUBCHANNEL 


STSCH 


S 


c 


p 


A 


SP 


OP 


* 


GS 


ST 


14-14 


B235 


TEST SUBCHANNEL 


TSCH 


S 


c 


p 


A 


SP 


OP 


$ 


GS 


ST 


14-16 


B236 


TEST PENDING INTERRUPTION 


TPI 


S 


c 


p 


A 1 


SP 




* 




ST 


14-15 


B237 


SET ADDRESS LIMIT 


SAL 


S 




p 






OP 


<f 


Gl 




14-9 


B238 


RESUME SUBCHANNEL 


RSCH 


S 


c 


p 






OP 


* 


GS 




14-8 


B239 


STORE CHANNEL REPORT WORD 


STCRW 


S 


c 


p 


A 


SP 




* 




ST 


14-14 


B23A 


STORE CHANNEL PATH STATUS 


STCPS 


S 




p 


A 


SP 




* 




ST 


14-13 


B23B 


RESET CHANNEL PATH 


RCHP 


S 


c 


p 






OP 


* 


Gl 




14-7 


B23C 


SET CHANNEL MONITOR 


SCHM 


S 




p 






OP 


<? 


GM 




14-10 


B6 


STORE CONTROL 


STCTL 


RS 




p 


A 


SP 








ST 


10-42 


B7 


LOAD CONTROL 


LCTL 


RS 




p 


A 


SP 










10-17 


BA 


COMPARE AND SWAP 


CS 


RS 


c 




A 


SP 




$ 




R ST 


7-19 


BB 


COMPARE DOUBLE AND SWAP 


CDS 


RS 


c 




A 


SP 




$ 




R ST 


7-19 


BD 


COMPARE LOGICAL C. UNDER MASK 


CLM 


RS 


c 




A 












7-21 


BE 


STORE CHARACTERS UNDER MASK 


STCM 


RS 






A 










ST 


7-42 


BF 


INSERT CHARACTERS UNDER MASK 


I CM 


RS 


c 




A 










R 


7-27 


Dl 


MOVE NUMERICS 


MVN 


SS 






A 










ST 


7-35 


D2 


MOVE (character) 


MVC 


SS 






A 










ST 


7-31 


D3 


MOVE ZONES 


MVZ 


SS 






A 










ST 


7-36 


D4 


AND (character) 


NC 


SS 


c 




A 










ST 


7-9 


D5 


COMPARE LOGICAL (character) 


CLC 


SS 


c 




A 












7-21 


D6 


OR (character) 


OC 


SS 


c 




A 










ST 


7-37 


D7 


EXCLUSIVE OR (character) 


XC 


SS 


c 




A 










ST 


7-25 


D9 


MOVE WITH KEY 


MVCK 


SS 


c 


Q 


A 










ST 


10-20 


DA 


MOVE TO PRIMARY 


MVCP 


SS 


c 


Q 


A 1 




SO 


* 




ST 


10-19 


DB 


MOVE TO SECONDARY 


MVCS 


SS 


c 


Q 


A 1 




so 


* 




ST 


10-19 


DC 


TRANSLATE 


TR 


SS 






A 










ST 


7-47 


DD 


TRANSLATE AND TEST 


TRT 


SS 


c 




A 








GM 


R 


7-47 


DE 


EDIT 


ED 


SS 


c 




A 




D 






ST 


8-6 


DF 


EDIT AND MARK 


EDMK 


SS 


c 




A 




D 




Gl 


R ST 


8-9 


E500 


LOAD ADDRESS SPACE PARAMETERS 


LASP 


SSE 


c 


P 


AS 


SP 


so 








10-10 


E501 


TEST PROTECTION 


TPROT 


SSE 


c 


P 


A 1 












10-46 


E8 


MOVE INVERSE 


MVCIN 


SS 


MI 




A 










ST 


7-31 


FO 


SHIFT AND ROUND DECIMAL 


SRP 


SS 


c 




A 




D 


DF 




ST 


8-10 


Fl 


MOVE WITH OFFSET 


MVO 


SS 






A 










ST 


7-35 


F2 


PACK 


PACK 


SS 






A 










ST 


7-38 


F3 


UNPACK 


UNPK 


SS 






A 










ST 


7-48 


F8 


ZERO AND ADD 


ZAP 


SS 


c 




A 




D 


DF 




ST 


8-12 


F9 


COMPARE DECIMAL 


CP 


SS 


c 




A 




D 








8-5 


FA 


ADD DECIMAL 


AP 


SS 


c 




A 




D 


DF 




ST 


8-5 


FB 


SUBTRACT DECIMAL 


SP 


SS 


c 




A 




D 


DF 




ST 


8-11 


FC 


MULTIPLY DECIMAL 


MP 


SS 






A 


SP 


D 






ST 


8-10 


FD 


DIVIDE DECIMAL 


DP 


SS 






A 


SP 


D 


DK 




ST 


8-5 



Instructions Arranged by Operation Code (Part 4 of 4) 
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APPENDIX <L. CONDITION-CODE SETTINGS 



This appendix lists the condition-code 
setting for all instructions in the 
370-XA architecture which set the condi- 
tion code. In addition to those 
instructions listed which set the condi- 
tion code, the condition code may be 
changed by DIAGNOSE and the target of 



EXECUTE. The condition code is loaded 
by LOAD PSW, by SET PROGRAM MASK, and by 
an interruption. The condition code is 
set to zero by initial CPU reset and is 
loaded by the successful conclusion of 
the initial-program-loading sequence. 



Instruction 


Condition Code 





1 


2 


3 


ADD, ADD HALFWORD 


Zero 


< zero 


> zero 


Overflow 


ADD DECIMAL 


Zero 


< zero 


> zero 


Overflow 


ADD LOGICAL 


Zero, 


Not zero, 


Zero, 


Not zero, 




no carry 


no carry 


carry 


carry 


ADD NORMALIZED 


Zero 


< zero 


> zero 


— 


ADD UNNORMALIZED 


Zero 


< zero 


> zero 


— 


AND 


Zero 


Not zero 


— 


— 


CLEAR SUBCHANNEL 


Function 
initiated 


— — 


— — 


Not operational 


COMPARE (gen, fl pt) 


Equal 


Low 


High 


— 


COMPARE HALFWORD 


Equal 


Low 


High 


— 


COMPARE AND FORM CODEWORD 


Equal 


OCB=0: low 
0CB=1: high 


OCB=0: high 
OCB=l: low 




COMPARE AND SWAP 


Equal 


Not equal 


— 





COMPARE DECIMAL 


Equal 


Low 


High 


— 


COMPARE DOUBLE AND SWAP 


Equal 


Not equal 


— 


— 


COMPARE LOGICAL 


Equal 


Low 


High 


— 


COMPARE LOGICAL CHARACTERS 


Equal 


Low 


High 


— 


UNDER MASK 










COMPARE LOGICAL LONG 


Equal 


Low 


High 


— 


EDIT, EDIT AND MARK 


Zero 


< zero 


> zero 


— 


EXCLUSIVE OR 


Zero 


Not zero 


— 


— 


HALT SUBCHANNEL 


Function 
initiated 


Status-pending 
with other 
than interme- 
diate status 


Busy 


Not operational 


INSERT ADDRESS SPACE CONTROL 


Zero 


One 


— 


— 


INSERT CHARACTERS UNDER MASK 


All zeros 


First bit one 


First bit zero 


— 


LOAD ADDRESS SPACE 


Parameters 


Primary ASN 


Secondary ASN 


Space-swi tch 


PARAMETERS 


loaded 


not avai lable 


not available 
or not 
authorized 


event 


LOAD AND TEST (gen, fl pt) 


Zero 


< zero 


> zero 


— 


LOAD COMPLEMENT (gen) 


Zero 


< zero 


> zero 


Overflow 


LOAD COMPLEMENT (fl pt) 


Zero 


< zero 


> zero 


— 


LOAD NEGATIVE (gen, fl pt) 


Zero 


< zero 


— 


-- 


LOAD POSITIVE (gen) 


Zero 


— 


> zero 


Overflow 


LOAD POSITIVE (fl pt) 


Zero 


— 


> zero 


— 


LOAD REAL ADDRESS 


Translation 


ST entry 


PT entry 


Length 




avai lable 


invalid 


invalid 


vi olati on 


MODIFY SUBCHANNEL 


SCHIB informa- 
tion placed 
in subchannel 


Status-pending 


Busy 


Not operational 


MOVE LONG 


Length equal 


Length low 


Length high 


Destructi ve 
overlap 


MOVE TO PRIMARY, MOVE TO 


Length =< 256 


— 


— 


Length > 256 


SECONDARY 










MOVE WITH KEY 


Length =< 256 


— 


— 


Length > 256 


OR 


Zero 


Not zero 


-- 


— 


RESET CHANNEL PATH 


Function 
ini tiated 




Busy 


Not operational 



Summary of Condition-Code Settings (Part 1 of 2) 
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Instruction 


Condition Code 







1 


2 


3 




RESET REFERENCE BIT 


R bit zero, 


R bit zero, 


R bit one, 


R bit one, 




EXTENDED 


C bit zero 


C bit one 


C bit zero 


C bit one 




RESUME SUBCHANNEL 


Function 
i ni tiated 


Status pending 


Function not 
applicable 


Not operational 




SET CLOCK 


Set 


Secure 


— 


Not operational 




SHIFT AND ROUND DECIMAL 


Zero 


< zero 


> zero 


Overflow 




SHIFT LEFT (DOUBLE/SINGLE) 


Zero 


< zero 


> zero 


Overflow 




SHIFT RIGHT (DOUBLE/SINGLE) 


Zero 


< zero 


> zero 


— 




SIGNAL PROCESSOR 


Order accepted 


Status stored 


Busy 


Not operational 




START SUBCHANNEL 


Functi on 
ini tiated 


Status-pendi ng 


Busy 


Not operational 




STORE CHANNEL REPORT WORD 


CRN stored 


Zeros stored 


-- 


-- 




STORE CLOCK 


Set 


Not set 


Error 


Not operational 




STORE SUBCHANNEL 


SCHIB stored 


— 


— 


Not operational 




SUBTRACT, SUBTRACT HALFWORD 


Zero 


< zero 


> zero 


Overflow 




SUBTRACT DECIMAL 


Zero 


< zero 


> zero 


Overflow 




SUBTRACT LOGICAL 


— 


Not zero, 


Zero, 


Not zero, 








no carry 


carry 


carry 




SUBTRACT NORMALIZED 


Zero 


< zero 


> zero 


— — 




SUBTRACT UNNORMALIZED 


Zero 


< zero 


> zero 


— 




TEST AND SET 


Left bit zero 


Left bit one 


— 


-- 




TEST BLOCK 


Usable 


Not usable 


— 


— 




TEST PENDING INTERRUPTION 


Interruption 
code not 
stored 


Interruption 
code stored 








TEST PROTECTION 


Can fetch, 


Can fetch, 


Cannot fetch, 


Translation not 






can store 


cannot store 


cannot store 


avai lable 




TEST SUBCHANNEL 


IRB stored; 
subchannel 
status- 
pending 


IRB stored; 
subchannel 
not status- 
pending 




Not operational 




TEST UNDER MASK 


All zeros 


Mixed 


— 


All ones 




TRANSLATE AND TEST 


All zeros 


Incomplete 


Complete 


-- 




UPDATE TREE 


Equal 


Not equal or 
no comparison 




Method 2, 

GR5 nonzero, 
GRO negative 




ZERO AND ADD 


Zero 


< zero 


> zero 


Overflow 




Explanation: 


n zero 










> zero Result greater tha 




< zero Result less than z 


ero 










=< 256 Equal to, or less 


than, 256 










> 256 Greater than 256 












High First operand high 












Low First operand low 












Length Length of first op 


erand 








1 


OCB Operand-control bi 


t 









Summary of Condition-Code Settings (Part 2 of 2) 
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APPENDIX D. COMPARISON BETWEEN SYSTEM/370 AND 37Q-XA MODES 



New Facilities in 370-XA Mode D-l 

Bi modal Addressing D-l 

31-Bit Logical Addressing D-l 

31-Bit Real and Absolute Addressing D-l 

Page Protection D-2 

Traci ng D-2 

Incorrect-Length-Indication Suppression D-2 

Status Verification D-2 

Comparison of Facilities D-2 

Summary of Changes D-4 

Changes in Instructions Provided D-4 

Input/Output Compari son D-7 

Compari son of PSW Formats D-7 

Changes in Control-Register Assignment D-7 

Changes in Assigned Storage Locations D-9 

SIGNAL PROCESSOR Changes D-9 

Machine-Check Changes D-9 

Changes to Addressing Wraparound D-10 

Changes to LOAD REAL ADDRESS D-10 

Changes to 31-Bit Real Operand Addresses D-10 



This appendix provides (1) a list of the 
new facilities in the 370-XA mode that 
&re not provided in the System/370 mode, 
(2) a description of the handling in the 
370-XA mode of the facilities available 
in the System/370 mode, and (3) a list 
of changes between the System/370 mode 
and the 370-XA mode. 



31-bit address arithmetic for operand 
address generation and includes exten- 
sions to the following addresses, which 
are always 31 bits, regardless of the 
addressing mode: 



Instruction address in 
33-63 



PSW bits 



NEW FACILITIES IN 370-XA MODE 



The following facilities are new with 
the 370-XA mode and are not provided in 
the System/37 mode. 



PER starting address in control 
register 10 



PER ending 
register 11 



address 



i n 



T ran slat i on-excepti on 
tion stored at real 
144-147 



control 

identi f i ca- 
locati ons 



BIMODAL ADDRESSING 



PER address stored at real loca- 
tions 152-155 



Two modes of ope 
24-bit address 
execution of old 
addressing mode, 
by bit 32 in th 
i nstructi ons are 
and set the mo 
conveniently p 
programs, which 
24-bit addressin 
which can take 
addressing mode. 



ration ar 

ing mode 

programs, 

The mode 
e PSW, an 

provi ded 
de. These 
ermit c 

must op 
g mode, an 
advantage 



e provided: a 

for the 

and a 31-bit 

is controlled 

d unpri vi leged 

that examine 

i nstructi ons 

ombining old 

erate in the 

d new programs 

of the 31-bit 



31-BIT LOGICAL ADDRESSING 



Monitor code stored at real loca- 
tions 156-159 

Entry instruction address in the 
entry-table entry 



31-BIT REAL AND ABSOLUTE ADDRESSING 



The following fields provide the left- 
most part of 31-bit addresses, or the 
entire address, as appropriate, regard- 
less of the setting of the addressing 
mode. Except where indicated, the 
addresses are real. 



The 31-bit logical addressing includes 
the ability to perform either 24-bit or 



Prefix register (absolute) 



Appendix D. Comparison Between System/370 and 370-XA Modes D-l 



Primary segment-table origin* in 
control register 1 

Linkage-table origin in control 
register 5 

Secondary segment-table origin* in 
control register 7 

ASN-f i rst-table origin it: control 
register 14 

Page-table origin in the segment- 
table entry 

Page-frame real address in the 
page-table entry 

ASN-second-table origin in the AFT 
entry 

Segment-table origin*, linkage- 
table origin, and authority-table 
origin in the AST entry 

Entry-table origin in the linkage- 
table entry 

Address in format-1 CCWs (absolute) 



* Unpredictable whether address is 
real or absolute 



PAGE PROTECTION 



A page-protection bit is provided in the 
page-table entry. Page protection can 
be used in a manner similar to the 
System/370-mode segment protection, 
which is not offered in the 370-XA mode. 



TRACING 



Included are a trace- 
branch trace control, ASN 
and explicit trace-con 
control register 12. Al 
the instruction TRACE 
program-interruption con 
trace-table exception, 
tracing is on, a trace en 
the successful execution 
ing instructions: 



table origin, 

trace control, 

trol bits in 

so included are 

and a new 

dition called 

When branch 

try is made for 

of the follow- 



BRANCH AND LINK (BALR) when the R a 
field is nonzero 

BRANCH AND SAVE (BASR) when the R a 
field is nonzero 

BRANCH AND SAVE AND SET MODE 
(BASSM) when the R 2 field is non- 
zero 

Uihen ASN tracing is on, an entry is made 
in the trace table for each execution of 
the following instructions: 

PROGRAM CALL 
PROGRAM TRANSFER 
SET SECONDARY ASN 

When explicit tracing is on, execution 
of TRACE causes a trace entry to be 
made. 



INCORRECT-LENGTH-INDICATION SUPPRESSION 



The incorrect 
si on facility 
incorrect len 
using format- 
as when usin 
the System/37 
of the ORB p 
indicating or 
incorrect len 
ti on. 



-length-indi cation-suppres- 
allows the indication of 
gth to be suppressed when 
1 CCWs in the same manner 
g format-0 CCWs or CCWs in 
mode. Bit 24 of word 1 
rovides the capability of 
suppressing recognition of 
gth for an immediate opera- 



STATUS VERIFICATION 



The status-verification facility 
provides an indication (bit 26 of the 
subchannel logout in the extended-status 
word) when the channel subsystem detects 
device status with a combination of bits 
that was inappropriate at the time 
status was presented. 



COMPARISON OF FACILITIES 



The figure "Availability of System/370 
Facilities in 370-XA Mode" shows the 
facilities offered in System/370 and 
whether or not the facility is provided 
in the 370-XA mode. 



D-2 370-XA Principles of Operation 



System/370 Facility 


Avai la- 

bility 

in 

370-XA 

Node 


Commercial instruction set 
Block-multiplexer channels 
Branch and save 
Byte-multiplexer channels 
Channel indirect data 
addressi ng 


P 1 

F 

B 

F 

B 


Channel-set switching 

Clear I/O 

Command retry 

Conditional swapping 

CPU timer and clock comparator 


F 

F 
B 
B 
B 


Direct control 
Dual address space 
Expanded storage 
Extended 

Extended-precision floating 
poi nt 


P* 
ES 

p3 

B 


Extended real addressing 
External signals 
Fast release 
Floating point 
Halt device 


R* 

F 
B 
F 


I/O extended logout 
Limited channel logout 
Move inverse 
Multiprocessi ng 


F 

MI 

B 5 


PSW-key handling 
Recovery extensions 
Segment protection 
Selector channels 


B 

R* 
F 


Service signal 
Start-I/O-fast queuing 
Storage-key-i nstructi on 

extensi ons 
Storage-key 4K-byte block 


B 
F 
B 

P 7 


Suspend and resume 
Test block 
Translation 
Vector 
31-bit IDAWs 


F 

B 
P e 

V 
B 



Explanation: 



B 
ES 



MI 



Not provided in the 370-XA mode. 
The following items, which are part 
of the basic computing function in 
the System/370 mode, are not pro- 
vided in the 370-XA mode: BC-mode, 
interval timer, and 2K-byte pro- 
tection blocks. Also see the fol- 
lowing instruction lists for those 
instructions basic in the System/ 
370 mode which are not provided in 
the 370-XA mode. 

All of the dual-address-space fa- 
cility is provided except for DAS 
tracing. 

See the following instruction list 
for those instructions that are 
part of the System/370 extended fa- 
cility and that are provided in the 
370-XA mode. 

Replaced with 31-bit real address- 
i ng. 

With the exception of the inclusion 
of more than one CPU, all the func- 
tions associated with the System/ 
370 multiprocessing facility are 
basic. 

Replaced by page protection. 
Only single-key 4K-byte protection 
blocks are provided, but the stor- 
age-key-exception control is not. 
The 370-XA translation provides 
only the 4K-byte page size and only 
the lM-byte segment size. See also 
the following instruction lists. 
Basic in the 370-XA mode. 
Provided in both the System/370 
and 370-XA modes as the expanded- 
storage facility. 
Not provided, but a comparable 
function is provided by the channel 
subsystem. 

Provided in both the System/370 and 
370-XA modes as the move-inverse 
faci li ty. 

Partially available in the 370-XA 
mode. 

Replaced with a comparable facil- 
ity. 

Provided in both the System/370 and 
and 370-XA modes as the vector fa- 
cility. 



Availability of System/370 Facilities 
in 370-XA Mode (Part 1 of 2) 



Availability of System/370 Facilities 
in 370-XA Mode (Part 2 of 2) 
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SUMMARY OF CHANGES 



CHANGES IN INSTRUCTIONS PROVIDED 



The following figures show those 
instructions which are optional or not 
provided in either the System/370 or the 
370-XA mode. Those instructions which 
are basic in both modes are not shown. 











System/ 








Mne- 


Op 


370 


370-XA 


Instruction Name* 




moni c 


Code 


Mode 


Mode 


BRANCH AND SAVE 




BASR 


OD 


BS 


B 


BRANCH AND SAVE 




BAS 


<tD 


BS 


B 


BRANCH AND SAVE AND SET MODE 




BASSM 


OC 


- 


B 


BRANCH AND SET MODE 




BSM 


OB 


- 


B 


COMPARE AND FORM CODEWORD 




CFC 


B21A 


- 


B 


COMPARE AND SWAP 




CS 


BA 


SW 


B 


COMPARE DOUBLE AND SWAP 




CDS 


BB 


SW 


B 


DIVIDE (extended) 




DXR 


B22D 


- 


B 


INSERT PROGRAM MASK 




IPM 


B222 


- 


B 


MOVE INVERSE 




MVCIN 


E8 


MI 


MI 


UPDATE TREE 




UPT 


0102 


- 


B 


Explanation: 








Instruction is not prov-ded. 


X Those instructions which are 


part of the f 


Loat ing-poi nt 


and extended-precision float 


ng-point faci 


Lities in the 


System/370 mode are basic in 


the 370-XA mo< 


de and are not 


shown. Similarly> those unprivileged inst 


ructi ons 


whi ch 


are part of the vector facil 


i ty are not sh< 


awn. 




B Instruction is basic. 








BS Branch-and-save facility. 








MI Move-inverse facility. 








SW Conditional-swapping facility. 







Unprivileged Instructions Provided 
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System/ 






Mne- 


Op 


370 


370-XA 


Instruction Name* 


monic 


Code 


Mode 


Mode 


CONNECT CHANNEL SET 


CONCS 


B200 


CS 


- 


DISCONNECT CHANNEL SET 


DISCS 


B201 


CS 


- 


EXTRACT PRIMARY ASN 


EPAR 


B226 


DU 


B 


EXTRACT SECONDARY ASN 


ESAR 


B227 


DU 


B 


INSERT ADDRESS SPACE CONTROL 


IAC 


B224 


DU 


B 


INSERT PSW KEY 


IPK 


B20B 


PK 


B 


INSERT STORAGE KEY 


ISK 


09 


B 


- 


INSERT STORAGE KEY EXTENDED 


ISKE 


B229 


EK 


B 


INSERT VIRTUAL STORAGE KEY 


IVSK 


B223 


DU 


B 


INVALIDATE PAGE TABLE ENTRY 


IPTE 


B221 


EF 


B 


LOAD ADDRESS SPACE PARAMETERS 


LASP 


E500 


DU 


B 


LOAD REAL ADDRESS 


LRA 


Bl 


TR 


B 


MOVE TO PRIMARY 


MVCP 


DA 


DU 


B 


MOVE TO SECONDARY 


MVCS 


DB 


DU 


B 


MOVE WITH KEY 


MVCK 


D9 


DU 


B 


PROGRAM CALL 


PC 


B218 


DU 


B 


PROGRAM TRANSFER 


PT 


B228 


DU 


B 


PURGE TLB 


PTLB 


B20D 


TR 


B 


READ DIRECT 


RDD 


85 


DC 


- 


RESET REFERENCE BIT 


RRB 


B213 


TR 


- 


RESET REFERENCE BIT EXTENDED 


RRBE 


B22A 


EK 


B 


SET ADDRESS SPACE CONTROL 


SAC 


B219 


DU 


B 


SET CLOCK COMPARATOR 


SCKC 


B206 


CK 


B 


SET CPU TIMER 


SPT 


B208 


CK 


B 


SET PREFIX 


SPX 


B210 


MP 


B 


SET PSW KEY FROM ADDRESS 


SPKA 


B20A 


PK 


B 


SET SECONDARY ASN 


SSAR 


B225 


DU 


B 


SET STORAGE KEY 


SSK 


08 


B 


- 


SET STORAGE KEY EXTENDED 


SSKE 


B22B 


EK 


B 


SIGNAL PROCESSOR 


SIGP 


AE 


MP 


B 


STORE CLOCK COMPARATOR 


STCKC 


B207 


CK 


B 


STORE CPU ADDRESS- 


STAP 


B212 


MP 


B 


STORE CPU TIMER 


STPT 


B209 


CK 


B 


STORE PREFIX 


STPX 


B211 


MP 


B 


STORE THEN AND SYSTEM MASK 


STNSM 


AC 


TR 


B 


STORE THEN OR SYSTEM MASK 


STOSM 


AD 


TR 


B 


TEST BLOCK 


TB 


B22C 


TB 


B 


TEST PROTECTION 


TPROT 


E501 


EF 


B 


TRACE 


TRACE 


99 


- 


B 


WRITE DIRECT 


WRD 


84 


DC 


- 


Explanati on: 










Instruction is not provided. 


x Those privileged instructions w 


tich a 


re pa 


rt of th< 


a vector 


facility are not shown. 










B Instruction is basic. 










CK CPU-timer and clock-comparator 


faci li 


ty. 






CS Channel-set-switching facility. 










DC Direct-control facility. 










DU Dual-address-space facility. 










EF Extended facility. 










EK Storage-key-i nstruct i on-extensi 


on fac 


ility 


. 




MP Multiprocessing facility. 










PK PSW-key-handling facility. 










TB Test-block facility. 










TR Translation facility. 











Control Instructions Provided 
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System/ 






Mne- 


Op 


370 


370-XA 


Instruction Name 


moni c 


Code 


Mode 


Mode 


CLEAR CHANNEL 


CLRCH 


9F01 


RE 


- 


CLEAR I/O 


CLRIO 


9D01 


B 


- 


HALT DEVICE 


HDV 


9E01 


HD 


- 


HALT I/O 


HIO 


9E00 


B 


- 


RESUME I/O 


RIO 


9C02 


SR 


- 


START I/O 


SIO 


9C00 


B 


- 


START I/O FAST RELEASE 


SIOF 


9C01 


FR 


- 


STORE CHANNEL ID 


STIDC 


B203 


B 


- 


TEST CHANNEL 


TCH 


9F00 


B 


- 


TEST I/O 


TIO 


9D00 


B 


- 


CLEAR SUBCHANNEL 


CSCH 


B230 


- 


B 


HALT SUBCHANNEL 


HSCH 


B231 


- 


B 


MODIFY SUBCHANNEL 


MSCH 


B232 


- 


B 


RESET CHANNEL PATH 


RCHP 


B23B 


- 


B 


RESUME SUBCHANNEL 


RSCH 


B238 


- 


B 


SET ADDRESS LIMIT 


SAL 


B237 


_ 


B 


SET CHANNEL MONITOR 


SCHM 


B23C 


- 


B 


START SUBCHANNEL 


SSCH 


B233 


- 


B 


STORE CHANNEL PATH STATUS 


STCPS 


B23A 


- 


B 


STORE CHANNEL REPORT WORD 


STCRW 


B239 


- 


B 


STORE SUBCHANNEL 


STSCH 


B234 


- 


B 


TEST PENDING INTERRUPTION 


TPI 


B236 


- 


B 


TEST SUBCHANNEL 


TSCH 


B235 


- 


B 


Explanati on: 








Instruction is not provided. 


B Instruction is basic. 








FR Performs the SIOF function only 


when 


the fast -release 



facility is installed in the channel 
HD Performs the HDV function only when the halt-device 

facility is installed in the channel. 
RE Performs the CLRCH function only when the recovery-exten- 
sion facility is installed in the channel. 
SR Suspend-and-resume facility. 



I/O Instructions Provided 
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INPUT/OUTPUT COMPARISON 



COMPARISON OF PSW FORMATS 



The channel subsystem 
logical structure from 
facilities provided in 
the result that I/O in 
nels, channel sets, an 
are replaced in the 370 
set of I/O instructi 
device addressing, a 
accessing mechanisms. 



has a different 
that of the I/O 
System/370, with 
structions, chan- 
d I/O addressing 
-XA mode by a new 
ons, by logical 
nd by device- 



Compatibility with System/370 has been 
maintained in the CCWs (format 0), 
31-bit IDAWs, and channel programs. 

In the System/370 mode, subchannels are 
not shared among channels, and each 
subchannel is associated with only one 
channel path. In the 370-XA mode, each 
subchannel is uniquely associated with 
one I/O device, and that I/O device is 
uniquely associated with that one 
subchannel within the channel subsystem, 
regardless of the number of channel 
paths by which the I/O device is acces- 
sible to the channel subsystem. 

Functions are provided in the channel 
subsystem in the 370-XA mode to detect 
malfunctions and recover from them if 
possible. Malfunctions are reported to 
the program by means of a channel 
report. 



In the Sys 
ruptions are 
which the 
connected, 
the I/O addr 
and device 
be stored at 
measurement 
location 185 
i nterruption 
in the confi 
and I/O-in 
stored in 
location 184 



tem/370 mode, I/O intei — 

accepted only by the CPU to 

channel set is currently 

The I/O interruption causes 

ess identifying the channel 

causing the interruption to 

locations 186-187, and the 

byte to be stored at real 

In the 370-XA mode, I/O 

s can be accepted by any CPU 

guration. The subsystem ID 

terruption parameter are 

the doubleword at real 



Associated with the new I/O instructions 
is a new program-interruption condition 
called operand exception. 



The figure "Comparison of PSW Formats" 
shows those bits and fields in the PSW 
which are different between the 
System/370 mode and the 370-XA mode. 







System/ 




Name of 


PSW 


370 


370-XA 


Bit or Field 


Bit 


Mode 


Mode 


PER Mask 


1 


TR 


B 


DAT Mode 


5 


TR 


B 


EC Mode 


12 






Bit 12 = 




B 


- 


(BC Mode) 








Bit 12 = 1 




TR 


B 1 


(EC Mode) 








Address-space 


16 


DU 


B 


control 








Addressing mode 


32 


- 


B 


Instruction address 


K 


B 


B 


Explanati on: 




Mode is not provided. 


X The instruction address is in PSW 


bits 40-63 in the System/370 mode 


and bits 33-63 in the 370-XA mode. 


1 In the 370-XA mode, PSW bit 12 


must be one, and the term "EC 


mode" is not used. 


B Basic. 


DU Provided as part of the dual- 


address-space facility. 


TR Provided as part of the transla- 


tion faci li ty . 



Comparison of PSW Formats 



CHANGES IN CONTROL-REGISTER ASSIGNMENT 



The figure "Differences in Control- 
Register Assignments" shows those bits 
and fields in the control registers 
which are different between the 
System/370 mode and the 370-XA mode. 
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Name of Bit or Field 


Control-Register Position 
for 


System/370 
Mode 


370-XA 
Mode 


Block-multiplexing control 
Fetch-protection override 
Storage-key-exception control 
Page-fault-assist control 
Interval-timer subclass mask 


0.0 

0.7 

0.13 

0.24 


0.6 


External-signal subclass mask 
Space-switch-event control 
Primary segment-table origin 
Primary segment-table length 
Channel masks 


0.26 

1.31 

1.8-1.25 

1.0-1.7 

2.0-2.31 


1.0 

1.1-1.19 

1.25-1.31 


Linkage-table origin 
I/O-i nterrupti on subclass mask 
Secondary segment-table length 
Secondary segment-table origin 
PER starting address 


5.8-5.24 

7.0-7.7 
7.8-7.25 
10.8-10.31 


5.1-5.24 
6.0-6.7 
7.25-7.31 
7.1-7.19 
10.1-10.31 


PER ending address 
Branch-trace control 
Trace-entry address 
ASN-trace control 
Explicit-trace control 


11.8-11.31 


11.1-11.31 

12.0 

12.1-12.29 

12.30 

12.31 


Check-stop control 
Synchronous-MCEL control 
I/O-extended-logout control 
Channel-report-pending subclass 

mask 
Asynchronous-MCEL control 
Asynchronous-fixed-log control 
ASN-f i rst-table origin 
MCEL address 


14.0 
14.1 
14.2 

14.8 

14.9 

14.20-14.31 

15.8-15.28 


14.3 
14.13-14.31 


Explanati on: 

Bit or field is not provided. 



Differences in Control-Register Assignments 
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CHANGES IN ASSIGNED STORAGE LOCATIONS 



The figure "Differences in Assigned 
Storage Locations" shows those 
assi gned-storage locations where changes 
have been made between the System/370 
mode and the 370-XA mode. 





Assi gned 




Storage 




Location and 




Length* for 


System/ 






370 


370-XA 


Name of Bit or Field 


Mode 


Mode 


Channel-status word 


64 8 


- 


Channel-address word 


72 4 


- 


Interval timer 


80 4 


- 


Trace-table designation 


84 4 


- 


Channel ID 


168 4 


- 


IOEL address 


172 4 


- 


Limited channel logout 


176 4 


- 


Subsystem ID 


- 


184 4 


Measurement byte 


185 1 


- 


I/O address 


186 2 


- 


I/O-i nterrupti on 


- 


188 4 


parameter 






Region code 


252 4 


- 


Fixed-logout area 


256 96 


256 16 


Store-status model- 


268 4 


- 


dependent save area 






CPU identity 


795 1 


— 


Explanation: 




Field is not provid< 


ad. 


x The first number is 


the address, 


the second the leng 


ih. 



the 370-XA mode. The parameter is used 
by the store-status-at-address and set- 
prefix orders. 



Name of Order 


Order Code 


System/ 

370 

Mode 


370-XA 
Mode 


Initial program reset 
Program reset 
Initial microprogram 

load 
Set prefix 
Store status at 

address 


07 
08 
0A 


0D 
0E 


Explanati on: 


ded. 




Order is not provit 



Signal-Processor Orders 



Name of Status Bit 


Bit Position 


System/37 
Mode 


370-XA 
Mode 


Incorrect state 
Invalid parameter 
Not ready 


28 


22 
23 


Explanation: 




Status bit is not provided. 





Differences in Assigned Storage 
Locati ons 



Signal-Processor Status Bits 



SIGNAL PROCESSOR CHANGES 



The figures "Signal-Processor Orders" 
and "Signal-Processor Status Bits" show 
those SIGNAL PROCESSOR orders and status 
codes where changes have been made 
between the System/370 mode and the 
370-XA mode. In addition to these 
changes, a parameter is provided as part 
of the SIGNAL PROCESSOR instruction in 



MACHINE-CHECK CHANGES 



The figure "Machine-Check-Interruption- 
Code Bits" summarizes those bits and 
fields in the machine-check-interruption 
code (MCIC) where changes have been made 
between the System/370 mode and the 
370-XA mode. In addition to these 
changes, the region code, the machine- 
check-extended logout, and asynchronous 
fixed logouts have been eliminated in 
the 370-XA mode. 
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Machi ne-Check- 

Interruption Condition 

or Field 



Interval-timer damage 
Channel report pending 
Channel -subsystem 

damage 
Delayed 

Region-code validity 
Logout validity 
MCEL length 



MCIC Bits 



System/ 
370 
Mode 



15 

25 

30 

48-63 



370-XA 
Mode 



9 
11 



Explanati on? 



Condition or field is not provided. 



Machi ne-Check-Interrupt i on-Code Bits 



Successive CCWs of a CCW list 
Successive IDAWs of an IDAW list 
Successive bytes of I/O data 

For DAT-table entries* it is model- 
dependent whether addresses wrap or 
cause an addressing exception. 



CHANGES TO LOAD REAL ADDRESS 



For LOAD REAL ADDRESS, the 
DAT tables is changed to 
able with respect to whe 
is applied and to be unpr 
respect to whether an add 
tion is recognized or wra 
when the calculated addre 
table or segment-table 
2 31 - 1. 



addressing of 
be unpredict- 
ther prefixing 
edictable with 
ressing excep- 
paround occurs 
ss of a page- 
entry exceeds 



CHANGES TO 31-BIT REAL OPERAND ADDRESSES 



CHANGES TO ADDRESSING WRAPAROUND 



In the 
from 2 2 
In the 
address 
wrap f 
versa) . 
effecti 
zero (o 
below, 
from 2 3 



System/370 mode, addresses wrap 
4 - 1 to zero (or vice versa). 

370-XA mode, for the 24-bit 
ing mode, effective addresses 
rom 2 24 - 1 to zero (or vice 

For the 31-bit addressing mode, 
ve addresses wrap from 2 31 - 1 to 
r vice versa). Except as noted 
real and absolute addresses wrap 
1 - 1 to zero. 



The following instructions operate by 
using 31-bit real addresses in the 
System/370 mode. In the 370-XA mode, 
these instructions operate under control 
of the addressing mode, bit 32 of the 
PSW. As a result, in the 24-bit 
addressing mode, these instructions 
operate by using 24-bit addresses. 

INSERT STORAGE KEY EXTENDED 
RESET REFERENCE BIT EXTENDED 
SET STORAGE KEY EXTENDED 
TEST BLOCK 



In the 370-XA mode, the following items 
cause an I/O program check instead of 
wraparound: 
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4 

8 

16 

32 

65 
131 
262 

524 

1,048 
2,097 
4,194 
8,388 

16,777 

33,554 

67,108 

134,217 

268,435 

536,870 

1,073,741 

2,147,483 

4,294,967 

8,589,934 

17,179,869 

34,359,738 

68,719,476 
137,438,953 
274,877,906 
549,755,813 

1,099,511,627 
2,199,023,255 
4,398,046,511 
8,796,093,022 

17,592,186,044 

35,184,372,088 

70,368,744,177 

140,737,488,355 

281,474,976,710 

562,949,953,421 

1,125,899,906,842 

2,251,799,813,685 

4,503,599,627,370 

9,007,199,254,740 

18,014,398,509,481 

36,028,797,018,963 

72,057,594,037,927 
144,115,188,075,855 
288,230,376,151,711 
576,460,752,303,423 

1,152,921,504,606,846 
2,305,843,009,213,693 
4,611,686,018,427,387 
9,223,372,036,854,775 



PLUS MINUS 

1 1. 

2 1 0.5 
4 2 0.25 
8 3 0.125 

16 4 0.0625 

32 5 0.03125 

64 6 0.01562 5 

128 7 0.00781 25 

256 8 0.00390 625 

512 9 0.00195 3125 

1,024 10 0.00097 65625 

2,048 11 0.00048 82812 5 

096 12 0.00024 41406 25 

192 13 0.00012 20703 125 

384 14 0.00006 10351 5625 

768 15 0.00003 05175 78125 

536 16 0.00001 52587 89062 5 

072 17 0.00000 76293 94531 25 

144 18 0.00000 38146 97265 625 

288 19 0.00000 19073 48632 8125 

576 20 0.00000 09536 74316 40625 

152 21 0.00000 04768 37158 20312 5 

304 22 0.00000 02384 18579 10156 25 

608 23 0.00000 01192 09289 55078 125 

216 24 0.00000 00596 04644 77539 0625 

432 25 0.00000 00298 02322 38769 53125 

864 26 0.00000 00149 01161 19384 76562 5 

728 27 0.00000 00074 50580 59692 38281 25 

456 28 0.00000 00037 25290 29846 19140 625 

912 29 0.00000 00018 62645 14923 09570 3125 

824 30 0.00000 00009 31322 57461 54785 15625 

648 31 0.00000 00004 65661 28730 77392 57812 5 

296 32 0.00000 00002 32830 64365 38696 28906 25 

592 33 0.00000 00001 16415 32182 69348 14453 125 

184 34 0.00000 00000 58207 66091 34674 07226 5625 

368 35 0.00000 00000 29103 83045 67337 03613 28125 

736 36 0.00000 00000 14551 91522 83668 51806 64062 5 

472 37 0.00000 00000 07275 95761 41834 25903 32031 25 

944 38 0.00000 00000 03637 97880 70917 12951 66015 625 

888 39 0.00000 00000 01818 98940 35458 56475 83007 8125 

776 40 0.00000 00000 00909 49470 17729 28237 91503 90625 

552 41 0.00000 00000 00454 74735 08864 64118 95751 95312 5 

104 42 0.00000 00000 00227 37367 54432 32059 47875 97656 25 

208 43 0.00000 00000 00113 68683 77216 16029 73937 98828 125 

416 44 0.00000 00000 00056 84341 88608 08014 86968 99414 0625 

832 45 0.00000 00000 00028 42170 94304 04007 43484 49707 03125 

664 46 0.00000 00000 00014 21085 47152 02003 71742 24853 51562 5 

328 47 0.00000 00000 00007 10542 73576 01001 85871 12426 75781 25 

656 48 0.00000 00000 00003 55271 36788 00500 92935 56213 37890 625 

312 49 0.00000 00000 00001 77635 68394 00250 46467 78106 68945 3125 

624 50 0.00000 00000 00000 88817 84197 00125 23233 89053 34472 65625 

248 51 0.00000 00000 00000 44408 92098 50062 61616 94526 67236 32812 5 

496 52 0.00000 00000 00000 22204 46049 25031 30808 47263 33618 16406 25 

992 53 0.00000 00000 00000 11102 23024 62515 65404 23631 66809 08203 125 

984 54 0.00000 00000 00000 05551 11512 31257 82702 11815 83404 54101 5625 

968 55 0.00000 00000 00000 02775 55756 15628 91351 05907 91702 27050 78125 

936 56 0.00000 00000 00000 01387 77878 07814 45675 52953 95851 13525 39062 5 

872 57 0.00000 00000 00000 00693 88939 03907 22837 76476 97925 56762 69531 25 

744 58 0.00000 00000 00000 00346 94469 51953 61418 88238 48962 78381 34765 625 

488 59 0.00000 00000 00000 00173 47234 75976 80709 44119 24481 39190 67382 8125 

976 60 0.00000 00000 00000 00086 73617 37988 40354 72059 62240 69595 33691 40625 

952 61 0.00000 00000 00000 00043 36808 68994 20177 36029 81120 34797 66845 70312 5 

904 62 0.00000 00000 00000 00021 68404 34497 10088 68014 90560 17398 83422 85156 25 

808 63 0.00000 00000 00000 00010 84202 17248 55044 34007 45280 08699 41711 42578 125 



18,446,744,073,709,551,616 64 0.00000 00000 00000 00005 42101 08624 27522 17003 72640 04349 70855 71289 0625 

Powers of 2 (Part 1 of 2) 



Appendix E. Table of Powers of 2 E-l 



18 

36 

73 

147 

295 

590 

1,180 

2,361 



4 
9 

18 
37 

75 
151 
302 
604 

1,208 
2,417 
4,835 
9,671 

19,342 

38,685 

77,371 

154,742 

309,485 

618,970 

1,237,940 

2,475,880 

4,951,760 

9,903,520 

19,807,040 

39,614,081 

79,228,162 
158,456,325 
316,912,650 
633,825,300 

1,267,650,600 

2,535,301,200 

5,070,602,400 

10,141,204,801 

20,282,409,603 

40,564,819,207 

81,129,638,414 

162,259,276,829 

324,518,553,658 

649,037,107,316 

1,298,074,214,633 

2,596,148,429,267 

5,192,296,858,534 
10,384,593,717,069 
20,769,187,434,139 
41,538,374,868,278 

83,076,749,736,557 
166,153,499,473,114 
332,306,998,946,228 
664,613,997,892,457 

1,329,227,995,784,915 

2,658,455,991,569,831 

5,316,911,983,139,663 

10,633,823,966,279,326 

21,267,647,932,558,653 

42,535,295,865,117,307 

85,070,591,730,234,615 

170,141,183,460,469,231 



722 
444 
889 
778 

557 
115 
231 
462 

925 
851 
703 
406 

813 
626 
252 

504 

009 
019 
039 
078 

157 
314 
628 
257 

514 
028 
057 
114 

228 
456 
912 
825 

651 
303 
606 
213 

426 
853 
706 
413 

827 
655 
310 
621 

242 
484 
968 
936 

872 
745 
491 
983 

966 
932 
865 
731 



,446 


744 


073 


709 


551, 


,893 


488 


147 


419 


103, 


,786 


976 


294 


838 


206, 


,573 


952 


589 


676 


412, 


,147 


905 


179 


352 


825, 


,295 


810 


358 


705 


651, 


,591 


620 


717 


411 


303, 


,183 


241 


434 


822 


606, 


,366 


482 


869 


645 


213, 


,732 


965 


739 


290 


427, 


,465 


931 


478 


580 


854, 


,931 


862 


957 


161 


709, 


,863 


725 


914 


323 


419, 


.727 


451 


828 


646 


838, 


,454 


903 


657 


293 


676, 


,909 


807 


314 


587 


353, 


,819 


614 


629 


174 


706, 


,639 


229 


258 


349 


412, 


,278 


458 


516 


698 


824, 


,556 


917 


033 


397 


649, 


,113 


834 


066 


795 


298, 


,227 


668 


133 


590 


597, 


,455 


336 


267 


181 


195, 


,910 


672 


534 


362 


390, 


,821 


345 


068 


724 


781, 


,642 


690 


137 


449 


562, 


,285 


380 


274 


899 


124, 


,570 


760 


549 


798 


248, 


,141 


521 


099 


596 


496, 


,283 


042 


199 


192 


993, 


,566 


084 


398 


385 


987, 


,132 


168 


796 


771 


975, 


,264 


337 


593 


543 


950, 


,528 


675 


187 


087 


900, 


,057 


350 


374 


175 


801, 


,114 


700 


748 


351 


602, 


,229 


401 


496 


703 


205, 


,458 


802 


993 


406 


410, 


,917 


605 


986 


812 


821, 


,835 


211 


973 


625 


643, 


,670 


423 


947 


251 


286, 


,340 


847 


894 


502 


572, 


,681 


695 


789 


005 


144, 


,363 


391 


578 


010 


288, 


,726 


783 


156 


020 


576, 


,453 


566 


312 


041 


152, 


,907 


132 


624 


082 


305, 


,814 


265 


248 


164 


610, 


,628 


530 


496 


329 


220, 


,257 


060 


992 


658 


440, 


,514 


121 


985 


316 


880, 


,028 


243 


970 


633 


760, 


,056 


487 


941 


267 


521, 


,112 


975 


882 


535 


043, 


,225 


951 


765 


070 


086, 


,451 


903 


530 


140 


172, 


,903 


807 


060 


280 


344, 


,807 


614 


120 


560 


689, 


,615 


228 


241 


121 


378, 


,230 


456 


482 


242 


756, 


,460 


912 


964 


485 


513, 


,921 


825 


928 


971 


026, 


,843 


651 


857 


942 


052, 


,687 


303 


715 


884 


105, 



616 


64 


232 


65 


464 


66 


928 


67 


856 


68 


712 


69 


424 


70 


848 


71 


696 


72 


392 


73 


784 


74 


568 


75 


136 


76 


272 


77 


544 


78 


088 


79 


176 


80 


352 


81 


704 


82 


408 


83 


816 


84 


632 


85 


264 


86 


528 


87 


056 


88 


112 


89 


224 


90 


448 


91 


896 


92 


792 


93 


584 


94 


168 


95 


336 


96 


672 


97 


344 


98 


688 


99 


376 


100 


752 


101 


504 


102 


008 


103 


016 


104 


032 


105 


064 


106 


128 


107 


256 


108 


512 


109 


024 


110 


048 


111 


096 


112 


192 


113 


384 


114 


768 


115 


536 


116 


072 


117 


144 


118 


288 


119 


576 


120 


152 


121 


304 


122 


608 


123 


216 


124 


432 


125 


864 


126 


728 


127 



340,282,366,920,938,463,463,374,607,431,768,211,456 128 



Powers of 2 (Part 2 of 2) 
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The following tables aid in converting hexadecimal values 
to decimal values, or the reverse. 

Direct Conversion Table 

This table provides direct conversion of decimal and 
hexadecimal numbers in these ranges: 



Hexadecimal 
000 to FFF 



Decimal 
0000 to 4095 



To convert numbers outside these ranges, and to con- 
vert fractions, use the hexadecimal and decimal conver- 
sion tables that follow the direct conversion table in this 
Appendix. 
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1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


00_ 


0000 


0001 


0002 


0003 


0004 


0005 


0006 


0007 


0008 


0009 


0010 


0011 


0012 


0013 


0014 


0015 


01_ 


0016 


0017 


0018 


0019 


0020 


0021 


0022 


0023 


0024 


0025 


0026 


0027 


0028 


0029 


0030 


0031 


02_ 


0032 


0033 


0034 


0035 


0036 


0037 


0038 


0039 


0040 


0041 


0042 


0043 


0044 


0045 


0046 


0047 


03_ 


0048 


0049 


0050 


0051 


0052 


0053 


0054 


0055 


0056 


0057 


0058 


0059 


0060 


0061 


0062 


0063 


04_ 


0064 


0065 


0066 


0067 


0068 


0069 


0070 


0071 


0072 


0073 


0074 


0075 


0076 


0077 


0078 


0079 


05_ 


0080 


0081 


0082 


0083 


0084 


0085 


0086 


0087 


0088 


0089 


0090 


0091 


0092 


0093 


0094 


0095 


06_ 


0096 


0097 


0098 


0099 


0100 


0101 


0102 


0103 


0104 


0105 


0106 


0107 


0108 


0109 


0110 


0111 


07_ 


0112 


0113 


0114 


0115 


0116 


0117 


0118 


0119 


0120 


0121 


0122 


0123 


0124 


0125 


0126 


0127 


08_ 


0128 


0129 


0130 


0131 


0132 


0133 


0134 


0135 


0136 


0137 


0138 


0139 


0140 


0141 


0142 


0143 


09_ 


0144 


0145 


0146 


0147 


0148 


0149 


0150 


0151 


0152 


0153 


0154 


0155 


0156 


0157 


0158 


0159 


0A_ 


0160 


0161 


0162 


0163 


0164 


0165 


0166 


0167 


0168 


0169 


0170 


0171 


0172 


0173 


0174 


0175 


0B_ 


0176 


0177 


0178 


0179 


0180 


0181 


0182 


0183 


0184 


0185 


0186 


0187 


0188 


0189 


0190 


0191 


0C_ 


0192 


0193 


0194 


0195 


0196 


0197 


0198 


0199 


0200 


0201 


0202 


0203 


0204 


0205 


0206 


0207 


0D_ 


0208 


0209 


0210 


0211 


0212 


0213 


0214 


0215 


0216 


0217 


0218 


0219 


0220 


0221 


0222 


0223 


0E_ 


0224 


0225 


0226 


0227 


0228 


0229 


0230 


0231 


0232 


0233 


0234 


0235 


0236 


0237 


0238 


0239 


0F_ 


0240 


0241 


0242 


0243 


0244 


0245 


0246 


0247 


0248 


0249 


0250 


0251 


0252 


0253 


0254 


0255 


10_ 


0256 


0257 


0258 


0259 


0260 


0261 


0262 


0263 


0264 


0265 


0266 


0267 


0268 


0269 


0270 


0271 


11_ 


0272 


0273 


0274 


0275 


0276 


0277 


0278 


0279 


0280 


0281 


0282 


0283 


0284 


0285 


0286 


0287 


12_ 


0288 


0289 


0290 


0291 


0292 


0293 


0294 


0295 


0296 


0297 


0298 


0299 


0300 


0301 


0302 


0303 


13_ 


0304 


0305 


0306 


0307 


0308 


0309 


0310 


0311 


0312 


0313 


0314 


0315 


0316 


0317 


0318 


0319 


14_ 


0320 


0321 


0322 


0323 


0324 


0325 


0326 


0327 


0328 


0329 


0330 


0331 


0332 


0333 


0334 


0335 


15_ 


0336 


0337 


0338 


0339 


0340 


0341 


0342 


0343 


0344 


0345 


0346 


0347 


0348 


0349 


0350 


0351 


16_ 


0352 


0353 


0354 


0355 


0356 


0357 


0358 


0359 


0360 


0361 


0362 


0363 


0364 


0365 


0366 


0367 


17_ 


0368 


0369 


0370 


0371 


0372 


0373 


0374 


0375 


0376 


0377 


0378 


0379 


0380 


0381 


0382 


0383 


18_ 


0384 


0385 


0386 


0387 


0388 


0389 


0390 


0391 


0392 


0393 


0394 


0395 


0396 


0397 


0398 


0399 


19_ 


0400 


0401 


0402 


0403 


0404 


0405 


0406 


0407 


0408 


0409 


0410 


0411 


0412 


0413 


0414 


0415 


1A_ 


0416 


0417 


0418 


0419 


0420 


0421 


0422 


0423 


0424 


0425 


0426 


0427 


0428 


0429 


0430 


0431 


1B_ 


0432 


0433 


0434 


0435 


0436 


0437 


0438 


0439 


0440 


0441 


0442 


0443 


0444 


0445 


0446 


0447 


1C_ 


0448 


0449 


0450 


0451 


0452 


0453 


0454 


0455 


0456 


0457 


0458 


0459 


0460 


0461 


0462 


0463 


1D_ 


0464 


0465 


0466 


0467 


0468 


0469 


0470 


0471 


0472 


0473 


0474 


0475 


0476 


0477 


0478 


0479 


IE 


0480 


0481 


0482 


0483 


0484 


0485 


0486 


0487 


0488 


0489 


0490 


0491 


0492 


0493 


0494 


0495 


1F_ 


0496 


0497 


0498 


0499 


0500 


0501 


0502 


0503 


0504 


0505 


0506 


0507 


0508 


0509 


0510 


0511 



Appendix F. Hexadecimal Tables F-l 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


20_ 


0512 


0513 


0514 


0515 


0516 


0517 


0518 


0519 


0520 


0521 


0522 


0523 


0524 


0525 


0526 


0527 


21_ 


0528 


0529 


0530 


0531 


0532 


0533 


0534 


0535 


0536 


0537 


0538 


0539 


0540 


0541 


0542 


0543 


22 


0544 


0545 


0546 


0547 


0548 


0549 


0550 


0551 


0552 


0553 


0554 


0555 


0556 


0557 


0558 


0559 


23_ 


0560 


0561 


0562 


0563 


0564 


0565 


0566 


0567 


0568 


0569 


0570 


0571 


0572 


0573 


0574 


0575 


24 


0576 


0577 


0578 


0579 


0580 


0581 


0582 


0583 


0584 


0585 


0586 


0587 


0588 


0589 


0590 


0591 


25_ 


0592 


0593 


0594 


0595 


0596 


0597 


0598 


0599 


0600 


0601 


0602 


0603 


0604 


0605 


0606 


0607 


26_ 


0608 


0609 


0610 


0611 


0612 


0613 


0614 


0615 


0616 


0617 


0618 


0619 


0620 


0621 


0622 


0623 


27_ 


0624 


0625 


0626 


0627 


0628 


0629 


0630 


0631 


0632 


0633 


0634 


0635 


0636 


0637 


0638 


0639 


28_ 


0640 


0641 


0642 


0643 


0644 


0645 


0646 


0647 


0648 


0649 


0650 


0651 


0652 


0653 


0654 


0655 


29 


0656 


0657 


0658 


0659 


0660 


0661 


0662 


0663 


0664 


0665 


0666 


0667 


0668 


0669 


0670 


0671 


2A 


0672 


0673 


0674 


0675 


0676 


0677 


0678 


0679 


0680 


0681 


0682 


0683 


0684 


0685 


0686 


0687 


2B_ 


0688 


0689 


0690 


0691 


0692 


0693 


0694 


0695 


0696 


0697 


0698 


0699 


0700 


0701 


0702 


0703 


2C_ 


0704 


0705 


0706 


0707 


0708 


0709 


0710 


0711 


0712 


0713 


0714 


0715 


0716 


0717 


0718 


0719 


2D 


0720 


0721 


0722 


0723 


0724 


0725 


0726 


0727 


0728 


0729 


0730 


0731 


0732 


0733 


0734 


0735 


2E 


0736 


0737 


0738 


0739 


0740 


0741 


0742 


0743 


0744 


0745 


0746 


0747 


0748 


0749 


0750 


0751 


2F_ 


0752 


0753 


0754 


0755 


0756 


0757 


0758 


0759 


0760 


0761 


0762 


0763 


0764 


0765 


0766 


0767 


30_ 


0768 


0769 


0770 


0771 


0772 


0773 


0774 


0775 


0776 


0777 


0778 


0779 


0780 


0781 


0782 


0783 


31_ 


0784 


0785 


0786 


0787 


0788 


0789 


0790 


0791 


0792 


0793 


0794 


0795 


0796 


0797 


0798 


0799 


32_ 


0800 


0801 


0802 


0803 


0804 


0805 


0806 


0807 


0808 


0809 


0810 


0811 


0812 


0813 


0814 


0815 


33_ 


0816 


0817 


0818 


0819 


0820 


0821 


0822 


0823 


0824 


0825 


0826 


0827 


0828 


0829 


0830 


0831 


34_ 


0832 


0833 


0834 


0835 


0836 


0837 


0838 


0839 


0840 


0841 


0842 


0843 


0844 


0845 


0846 


0847 


35_ 


0848 


0849 


0850 


0851 


0852 


0853 


0854 


0855 


0856 


0857 


0858 


0859 


0860 


0861 


0862 


0863 


36_ 


0864 


0865 


0866 


0867 


0868 


0869 


0870 


0871 


0872 


0873 


0874 


0875 


0876 


0877 


0878 


0879 


37_ 


0880 


0881 


0882 


0883 


0884 


0885 


0886 


0887 


0888 


0889 


0890 


0891 


0892 


0893 


0894 


0895 


38_ 


0896 


0897 


0898 


0899 


0900 


0901 


0902 


0903 


0904 


0905 


0906 


0907 


0908 


0909 


0910 


0911 


39_ 


0912 


0913 


0914 


0915 


0916 


0917 


0918 


0919 


0920 


0921 


0922 


0923 


0924 


0925 


0926 


0927 


3A_ 


0928 


0929 


0930 


0931 


0932 


0933 


0934 


0935 


0936 


0937 


0938 


0939 


0940 


0941 


0942 


0943 


3B_ 


0944 


0945 


0946 


0947 


0948 


0949 


0950 


0951 


0952 


0953 


0954 


0955 


0956 


0957 


0958 


0959 


3C_ 


0960 


0961 


0962 


0963 


0964 


0965 


0966 


0967 


0968 


0969 


0970 


0971 


0972 


0973 


0974 


0975 


3D_ 


0976 


0977 


0978 


0979 


0980 


0981 


0982 


0983 


0984 


0985 


0986 


0987 


0988 


0989 


0990 


0991 


3E_ 


0992 


0993 


0994 


0995 


0996 


0997 


0998 


0999 


1000 


1001 


1002 


1003 


1004 


1005 


1006 


1007 


3F_ 


1008 


1009 


1010 


1011 


1012 


1013 


1014 


1015 


1016 


1017 


1018 


1019 


1020 


1021 


1022 


1023 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


40_ 


1024 


1025 


1026 


1027 


1028 


1029 


1030 


1031 


1032 


1033 


1034 


1035 


1036 


1037 


1038 


1039 


41_ 


1040 


1041 


1042 


1043 


1044 


1045 


1046 


1047 


1048 


1049 


1050 


1051 


1052 


1053 


1054 


1055 


42 


1056 


1057 


1058 


1059 


1060 


1061 


1062 


1063 


1064 


1065 


1066 


1067 


1068 


1069 


1070 


1071 


43_ 


1072 


1073 


1074 


1075 


1076 


1077 


1078 


1079 


1080 


1081 


1082 


1083 


1084 


1085 


1086 


1087 


44 


1088 


1089 


1090 


1091 


1092 


1093 


1094 


1095 


1096 


1097 


1098 


1099 


1100 


1101 


1102 


1103 


45_ 


1104 


1105 


1106 


1107 


1108 


1109 


1110 


1111 


1112 


1113 


1114 


1115 


1116 


1117 


1118 


1119 


46_ 


1120 


1121 


1122 


1123 


1124 


1125 


1126 


1127 


1128 


1129 


1130 


1131 


1132 


1133 


1134 


1135 


47_ 


1136 


1137 


1138 


1139 


1140 


1141 


1142 


1143 


1144 


1145 


1146 


1147 


1148 


1149 


1150 


1151 


48_ 


1152 


1153 


1154 


1155 


1156 


1157 


1158 


1159 


1160 


1161 


1162 


1163 


1164 


1165 


1166 


1167 


49_ 


1168 


1169 


1170 


1171 


1172 


1173 


1174 


1175 


1176 


1177 


1178 


1179 


1180 


1181 


1182 


1183 


4A 


1184 


1185 


1186 


1187 


1188 


1189 


1190 


1191 


1192 


1193 


1194 


1195 


1196 


1197 


1198 


1199 


4B_ 


1200 


1201 


1202 


1203 


1204 


1205 


1206 


1207 


1208 


1209 


1210 


1211 


1212 


1213 


1214 


1215 


4C_ 


1216 


1217 


1218 


1219 


1220 


1221 


1222 


1223 


1224 


1225 


1226 


1227 


1228 


1229 


1230 


1231 


4D_ 


1232 


1233 


1234 


1235 


1236 


1237 


1238 


1239 


1240 


1241 


1242 


1243 


1244 


1245 


1246 


1247 


4E 


1248 


1249 


1250 


1251 


1252 


1253 


1254 


1255 


1256 


1257 


1258 


1259 


1260 


1261 


1262 


1263 


4F_ 


1264 


1265 


1266 


1267 


1268 


1269 


1270 


1271 


1272 


1273 


1274 


1275 


1276 


1277 


1278 


1279 


50_ 


1280 


1281 


1282 


1283 


1284 


1285 


1286 


1287 


1288 


1289 


1290 


1291 


1292 


1293 


1294 


1295 


51_ 


1296 


1297 


1298 


1299 


1300 


1301 


1302 


1303 


1304 


1305 


1306 


1307 


1308 


1309 


1310 


1311 


52_ 


1312 


1313 


1314 


1315 


1316 


1317 


1318 


1319 


1320 


1321 


1322 


1323 


1324 


1325 


1326 


1327 


53_ 


1328 


1329 


1330 


1331 


1332 


1333 


1334 


1335 


1336 


1337 


1338 


1339 


1340 


1341 


1342 


1343 


54_ 


1344 


1345 


1346 


1347 


1348 


1349 


1350 


1351 


1352 


1353 


1354 


1355 


1356 


1357 


1358 


1359 


55_ 


1360 


1361 


1362 


1363 


1364 


1365 


1366 


1367 


1368 


1369 


1370 


1371 


1372 


1373 


1374 


1375 


56_ 


1376 


1377 


1378 


1379 


1380 


1381 


1382 


1383 


1384 


1385 


1386 


1387 


1388 


1389 


1390 


1391 


57_ 


1392 


1393 


1394 


1395 


1396 


1397 


1398 


1399 


1400 


1401 


1402 


1403 


1404 


1405 


1406 


1407 


58_ 


1408 


1409 


1410 


1411 


1412 


1413 


1414 


1415 


1416 


1417 


1418 


1419 


1420 


1421 


1422 


1423 


59_ 


1424 


1425 


1426 


1427 


1428 


1429 


1430 


1431 


1432 


1433 


1434 


1435 


1436 


1437 


1438 


1439 


5A_ 


1440 


1441 


1442 


1443 


1444 


1445 


1446 


1447 


1448 


1449 


1450 


1451 


1452 


1453 


1454 


1455 


5B_ 


1456 


1457 


1458 


1459 


1460 


1461 


1462 


1463 


1464 


1465 


1466 


1467 


1468 


1469 


1470 


1471 


5C_ 


1472 


1473 


1474 


1475 


1476 


1477 


1478 


1479 


1480 


1481 


1482 


1483 


1484 


1485 


1486 


1487 


5D_ 


1488 


1489 


1490 


1491 


1492 


1493 


1494 


1495 


1496 


1497 


1498 


1499 


1500 


1501 


1502 


1503 


5E_ 


1504 


1505 


1506 


1507 


1508 


1509 


1510 


1511 


1512 


1513 


1514 


1515 


1516 


1517 


1518 


1519 


5F_ 


1520 


1521 


1522 


1523 


1524 


1525 


1526 


1527 


1528 


1529 


1530 


1531 


1532 


1533 


1534 


1535 



F-2 370-XA Principles of Operation 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


60_ 


1536 


1537 


1538 


1539 


1540 


1541 


1542 


1543 


1544 


1545 


1546 


1547 


1548 


1549 


1550 


1551 


61_ 


1552 


1553 


1554 


1555 


1556 


1557 


1558 


1559 


1560 


1561 


1562 


1563 


1564 


1565 


1566 


1567 


62_ 


1568 


1569 


1570 


1571 


1572 


1573 


1574 


1575 


1576 


1577 


1578 


1579 


1580 


1581 


1582 


1583 


63_ 


1584 


1585 


1586 


1587 


1588 


1589 


1590 


1591 


1592 


1593 


1594 


1595 


1596 


1597 


1598 


1599 


64_ 


1600 


1601 


1602 


1603 


1604 


1605 


1606 


1607 


1608 


1609 


1610 


1611 


1612 


1613 


1614 


1615 


65_ 


1616 


1617 


1618 


1619 


1620 


1621 


1622 


1623 


1624 


1625 


1626 


1627 


1628 


1629 


1630 


1631 


66_ 


1632 


1633 


1634 


1635 


1636 


1637 


1638 


1639 


1640 


1641 


1642 


1643 


1644 


1645 


1646 


1647 


67_ 


1648 


1649 


1650 


1651 


1652 


1653 


1654 


1655 


1656 


1657 


1658 


1659 


1660 


1661 


1662 


1663 


68_ 


1664 


1665 


1666 


1667 


1668 


1669 


1670 


1671 


1672 


1673 


1674 


1675 


1676 


1677 


1678 


1679 


69_ 


1680 


1681 


1682 


1683 


1684 


1685 


1686 


1687 


1688 


1689 


1690 


1691 


1692 


1693 


1694 


1695 


6A_ 


1696 


1697 


1698 


1699 


1700 


1701 


1702 


1703 


1704 


1705 


1706 


1707 


1708 


1709 


1710 


1711 


6B_ 


1712 


1713 


1714 


1715 


1716 


1717 


1718 


1719 


1720 


1721 


1722 


1723 


1724 


1725 


1726 


1727 


6C_ 


1728 


1729 


1730 


1731 


1732 


1733 


1734 


1735 


1736 


1737 


1738 


1739 


1740 


1741 


1742 


1743 


6D_ 


1744 


1745 


1746 


1747 


1748 


1749 


1750 


1751 


1752 


1753 


1754 


1755 


1756 


1757 


1758 


1759 


6E_ 


1760 


1761 


1762 


1763 


1764 


1765 


1766 


1767 


1768 


1769 


1770 


1771 


1772 


1773 


1774 


1775 


6F_ 


1776 


1777 


1778 


1779 


1780 


1781 


1782 


1783 


1784 


1785 


1786 


1787 


1788 


1789 


1790 


1791 


70_ 


1792 


1793 


1794 


1795 


1796 


1797 


1798 


1799 


1800 


1801 


1802 


1803 


1804 


1805 


1806 


1807 


71_ 


1808 


1809 


1810 


1811 


1812 


1813 


1814 


1815 


1816 


1817 


1818 


1819 


1820 


1821 


1822 


1823 


72_ 


1824 


1825 


1826 


1827 


1828 


1829 


1830 


1831 


1832 


1833 


1834 


1835 


1836 


1837 


1838 


1839 


73_ 


1840 


1841 


1842 


1843 


1844 


1845 


1846 


1847 


1848 


1849 


1850 


1851 


1852 


1853 


1854 


1855 


74_ 


1856 


1857 


1858 


1859 


1860 


1861 


1862 


1863 


1864 


1865 


1866 


1867 


1868 


1869 


1870 


1871 


75_ 


1872 


1873 


1874 


1875 


1876 


1877 


1878 


1879 


1880 


1881 


1882 


1883 


1884 


1885 


1886 


1887 


76_ 


1888 


1889 


1890 


1891 


1892 


1893 


1894 


1895 


1896 


1897 


1898 


1899 


1900 


1901 


1902 


1903' 


77_ 


1904 


1905 


1906 


1907 


1908 


1909 


1910 


1911 


1912 


1913 


1914 


1915 


1916 


1917 


1918 


1919 


78_ 


1920 


1921 


1922 


1923 


1924 


1925 


1926 


1927 


1928 


1929 


1930 


1931 


1932 


1933 


1934 


1935 


79_ 


1936 


1937 


1938 


1939 


1940 


1941 


1942 


1943 


1944 


1945 


1946 


1947 


1948 


1949 


1950 


1951 


7A_ 


1952 


1953 


1954 


1955 


1956 


1957 


1958 


1959 


1960 


1961 


1962 


1963 


1964 


1965 


1966 


1967 


7B_ 


1968 


1969 


1970 


1971 


1972 


1973 


1974 


1975 


1976 


1977 


1978 


1979 


1980 


1981 


1982 


1983 


7C_ 


1984 


1985 


1986 


1987 


1988 


1989 


1990 


1991 


1992 


1993 


1994 


1995 


1996 


1997 


1998 


1999 


7D_ 


2000 


2001 


2002 


2003 


2004 


2005 


2006 


2007 


2008 


2009 


2010 


2011 


2012 


2013 


2014 


2015 


7E_ 


2016 


2017 


2018 


2019 


2020 


2021 


2022 


2023 


2024 


2025 


2026 


2027 


2028 


2029 


2030 


2031 


7F_ 


2032 


2033 


2034 


2035 


2036 


2037 


2038 


2039 


2040 


2041 


2042 


2043 


2044 


2045 


2046 


2047 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


80_ 


2048 


2049 


2050 


2051 


2052 


2053 


2054 


2055 


2056 


2057 


2058 


2059 


2060 


2061 


2062 


2063 


81_ 


2064 


2065 


2066 


2067 


2068 


2069 


2070 


2071 


2072 


2073 


2074 


2075 


2076 


2077 


2078 


2079 


82_ 


2080 


2081 


2082 


2083 


2084 


2085 


2086 


2087 


2088 


2089 


2090 


2091 


2092 


2093 


2094 


2095 


83_ 


2096 


2097 


2098 


2099 


2100 


2101 


2102 


2103 


2104 


2105 


2106 


2107 


2108 


2109 


2110 


2111 


84_ 


2112 


2113 


2114 


2115 


2116 


2117 


2118 


2119 


2120 


2121 


2122 


2123 


2124 


2125 


2126 


2127 


85_ 


2128 


2129 


2130 


2131 


2132 


2133 


2134 


2135 


2136 


2137 


2138 


2139 


2140 


2141 


2142 


2143 


86 


2144 


2145 


2146 


2147 


2148 


2149 


2150 


2151 


2152 


2153 


2154 


2155 


2156 


2157 


2158 


2159 


87_ 


2160 


2161 


2162 


2163 


2164 


2165 


2166 


2167 


2168 


2169 


2170 


2171 


2172 


2173 


2174 


2175 


88_ 


2176 


2177 


2178 


2179 


2180 


2181 


2182 


2183 


2184 


2185 


2186 


2187 


2188 


2189 


2190 


2191 


89_ 


2192 


2193 


2194 


2195 


2196 


2197 


2198 


2199 


2200 


2201 


2202 


2203 


2204 


2205 


2206 


2207 


8A 


2208 


2209 


2210 


2211 


2212 


2213 


2214 


2215 


2216 


2217 


2218 


2219 


2220 


2221 


2222 


2223 


8B_ 


2224 


2225 


2226 


2227 


2228 


2229 


2230 


2231 


2232 


2233 


2234 


2235 


2236 


2237 


2238 


2239 


8C_ 


2240 


2241 


2242 


2243 


2244 


2245 


2246 


2247 


2248 


2249 


2250 


2251 


2252 


2253 


2254 


2255 


8D_ 


2256 


2257 


2258 


2259 


2260 


2261 


2262 


2263 


2264 


2265 


2266 


2267 


2268 


2269 


2270 


2271 


8E_ 


2272 


2273 


2274 


2275 


2276 


2277 


2278 


2279 


2280 


2281 


2282 


2283 


2284 


2285 


2286 


2287 


8F_ 


2288 


2289 


2290 


2291 


2292 


2293 


2294 


2295 


2296 


2297 


2298 


2299 


2300 


2301 


2302 


2303 


90_ 


2304 


2305 


2306 


2307 


2308 


2309 


2310 


2311 


2312 


2313 


2314 


2315 


2316 


2317 


2318 


2319 


91 


2320 


2321 


2322 


2323 


2324 


2325 


2326 


2327 


2328 


2329 


2330 


2331 


2332 


2333 


2334 


2335 


92_ 


2336 


2337 


2338 


2339 


2340 


2341 


2342 


2343 


2344 


2345 


2346 


2347 


2348 


2349 


2350 


2351 


93_ 


2352 


2353 


2354 


2355 


2356 


2357 


2358 


2359 


2360 


2361 


2362 


2363 


2364 


2365 


2366 


2367 


94_ 


2368 


2369 


2370 


2371 


2372 


2373 


2374 


2375 


2376 


2377 


2378 


2379 


2380 


2381 


2382 


2383 


95_ 


2384 


2385 


2386 


2387 


2388 


2389 


2390 


2391 


2392 


2393 


2394 


2395 


2396 


2397 


2398 


2399 


96_ 


2400 


2401 


2402 


2403 


2404 


2405 


2406 


2407 


2408 


2409 


2410 


2411 


2412 


2413 


2<*14 


2415 


97_ 


2416 


2417 


241,8 


2419 


2420- 


2421 


2422 


2423 


2424 


2425 


2426 


2427 


2428 


2429 


2430 


2431 


98_ 


2432 


2433 


2434 


2435 


2436 


2437 


2438 


2439 


2440 


2441 


2442 


2443 


2444 


2445 


2446 


2447 


99_ 


2448 


2449 


2450 


2451 


2452 


2453 


2454 


2455 


2456 


2457 


2458 


2459 


2460 


2461 


2462 


2463 


9A_ 


2464 


2465 


2466 


2467 


2468 


2469 


2470 


2471 


2472 


2473 


2474 


2475 


2476 


2477 


2478 


2479 


9B_ 


2480 


2481 


2482 


2483 


2484 


2485 


2486 


2487 


2488 


2489 


2490 


2491 


2492 


2493 


2494 


2495 


9C_ 


2496 


2497 


2498 


2499 


2500 


2501 


2502 


2503 


2504 


2505 


2506 


2507 


2508 


2509 


2510 


2511 


9D_ 


2512 


2513 


2514 


2515 


2516 


2517 


2518 


2519 


2520 


2521 


2522 


2523 


2524 


2525 


2526 


2527 


9E_ 


2528 


2529 


2530 


2531 


2532 


2533 


2534 


2535 


2536 


2537 


2538 


2539 


2540 


2541 


2542 


2543 


9F_ 


2544 


2545 


2546 


2547 


2548 


2549 


2550 


2551 


2552 


2553 


2554 


2555 


2556 


2557 


2558 


2559 



Appendix F. Hexadecimal Tables F-3 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


A0_ 


2560 


2561 


2562 


2563 


2564 


2565 


2566 


2567 


2568 


2569 


2570 


2571 


2572 


2573 


2574 


2575 


Al_ 


2576 


2577 


2578 


2579 


2580 


2581 


2582 


2583 


2584 


2585 


2586 


2587 


2588 


2589 


2590 


2591 


A2 


2592 


2593 


2594 


2595 


2596 


2597 


2598 


2599 


2600 


2601 


2602 


2603 


2604 


2605 


2606 


2607 


A3_ 


2608 


2609 


2610 


2611 


2612 


2613 


2614 


2615 


2616 


2617 


2618 


2619 


2620 


2621 


2622 


2623 


A4 


2624 


2625 


2626 


2627 


2628 


2629 


2630 


2631 


2632 


2633 


2634 


2635 


2636 


2637 


2638 


2639 


A5_ 


2640 


2641 


2642 


2643 


2644 


2645 


2646 


2647 


2648 


2649 


2650 


2651 


2652 


2653 


2654 


2655 


A6_ 


2656 


2657 


2658 


2659 


2660 


2661 


2662 


2663 


2664 


2665 


2666 


2667 


2668 


2669 


2670 


2671 


A7_ 


2672 


2673 


2674 


2675 


2676 


2677 


2678 


2679 


2680 


2681 


2682 


2683 


2684 


2685 


2686 


2687 


A8_ 


2688 


2689 


2690 


2691 


2692 


2693 


2694 


2695 


2696 


2697 


2698 


2699 


2700 


2701 


2702 


2703 


A9_ 


2704 


2705 


2706 


2707 


2708 


2709 


2710 


2711 


2712 


2713 


2714 


2715 


2716 


2717 


2718 


2719 


AA_ 


2720 


2721 


2722 


2723 


2724 


2725 


2726 


2727 


2728 


2729 


2730 


2731 


2732 


2733 


2734 


2735 


AB_ 


2736 


2737 


2738 


2739 


2740 


2741 


2742 


2743 


2744 


2745 


2746 


2747 


2748 


2749 


2750 


2751 


AC_ 


2752 


2753 


2754 


2755 


2756 


2757 


2758 


2759 


2760 


2761 


2762 


2763 


2764 


2765 


2766 


2767 


AD 


2768 


2769 


2770 


2771 


2772 


2773 


2774 


2775 


2776 


2777 


2778 


2779 


2780 


2781 


2782 


2783 


AE_ 


2784 


2785 


2786 


2787 


2788 


2789 


2790 


2791 


2792 


2793 


2794 


2795 


2796 


2797 


2798 


2799 


AF_ 


2800 


2801 


2802 


2803 


2804 


2805 


2806 


2807 


2808 


2809 


2810 


2811 


2812 


2813 


2814 


2815 


B0_ 


2816 


2817 


2818 


2819 


2820 


2821 


2822 


2823 


2824 


2825 


2826 


2827 


2828 


2829 


2830 


2831 


Bl_ 


2832 


2833 


2834 


2835 


2836 


2837 


2838 


2839 


2840 


2841 


2842 


2843 


2844 


2845 


2846 


2847 


B2_ 


2848 


2849 


2850 


2851 


2852 


2853 


2854 


2855 


2856 


2857 


2858 


2859 


2860 


2861 


2862 


2863 


B3_ 


2864 


2865 


2866 


2867 


2868 


2869 


2870 


2871 


2872 


2873 


2874 


2875 


2876 


2877 


2878 


2879 


B4_ 


2880 


2881 


2882 


2883 


2884 


2885 


2886 


2887 


2888 


2889 


2890 


2891 


2892 


2893 


2894 


2895 


B5_ 


2896 


2897 


2898 


2899 


2900 


2901 


2902 


2903 


2904 


2905 


2906 


2907 


2908 


2909 


2910 


2911 


B6 


2912 


2913 


2914 


2915 


2916 


2917 


2918 


2919 


2920 


2921 


2922 


2923 


2924 


2925 


2926 


2927 


B7_ 


2928 


2929 


2930 


2931 


2932 


2933 


2934 


2935 


2936 


2937 


2938 


2939 


2940 


2941 


2942 


2943 


B8_ 


2944 


2945 


2946 


2947 


2948 


2949 


2950 


2951 


2952 


2953 


2954 


2955 


2956 


2957 


2958 


2959 


B9_ 


2960 


2961 


2962 


2963 


2964 


2965 


2966 


2967 


2968 


2969 


2970 


2971 


2972 


2973 


2974 


2975 


BA_ 


2976 


2977 


2978 


2979 


2980 


2981 


2982 


2983 


2984 


2985 


2986 


2987 


2988 


2989 


2990 


2991 


BB_ 


2992 


2993 


2994 


2995 


2996 


2997 


2998 


2999 


3000 


3001 


3002 


3003 


3004 


3005 


3006 


3007 


BC_ 


3008 


3009 


3010 


3011 


3012 


3013 


3014 


3015 


3016 


3017 


3018 


3019 


3020 


3021 


3022 


3023 


BD_ 


3024 


3025 


3026 


3027 


3028 


3029 


3030 


3031 


3032 


3033 


3034 


3035 


3036 


3037 


3038 


3039 


BE_ 


3040 


3041 


3042 


3043 


3044 


3045 


3046 


3047 


3048 


3049 


3050 


3051 


3052 


3053 


3054 


3055 


BF_ 


3056 


3057 


3058 


3059 


3060 


3061 


3062 


3063 


3064 


3065 


3066 


3067 


3068 


3069 


3070 


3071 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


C0_ 


3072 


3073 


3074 


3075 


3076 


3077 


3078 


3079 


3080 


3081 


3082 


3083 


3084 


3085 


3086 


3087 


CI 


3088 


3089 


3090 


3091 


3092 


3093 


3094 


3095 


3096 


3097 


3098 


3099 


3100 


3101 


3102 


3103 


C2_ 


3104 


3105 


3106 


3107 


3108 


3109 


3110 


3111 


3112 


3113 


3114 


3115 


3116 


3117 


3118 


3119 


C3_ 


3120 


3121 


3122 


3123 


3124 


3125 


3126 


3127 


3128 


3129 


3130 


3131 


3132 


3133 


3134 


3135 


C4 


3136 


3137 


3138 


3139 


3140 


3141 


3142 


3143 


3144 


3145 


3146 


3147 


3148 


3149 


3150 


3151 


C5_ 


3152 


3153 


3154 


3155 


3156 


3157 


3158 


3159 


3160 


3161 


3162 


3163 


3164 


3165 


3166 


3167 


C6 


3168 


3169 


3170 


3171 


3172 


3173 


3174 


3175 


3176 


3177 


3178 


3179 


3180 


3181 


3182 


3183 


C7_ 


3184 


3185 


3186 


3187 


3188 


3189 


3190 


3191 


3192 


3193 


3194 


3195 


3196 


3197 


3198 


3199 


C8_ 


3200 


3201 


3202 


3203 


3204 


3205 


3206 


3207 


3208 


3209 


3210 


3211 


3212 


3213 


3214 


3215 


C9 


3216 


3217 


3218 


3219 


3220 


3221 


3222 


3223 


3224 


3225 


3226 


3227 


3228 


3229 


3230 


3231 


CA 


3232 


3233 


3234 


3235 


3236 


3237 


3238 


3239 


3240 


3241 


3242 


3243 


3244 


3245 


3246 


3247 


CB_ 


3248 


3249 


3250 


3251 


3252 


3253 


3254 


3255 


3256 


3257 


3258 


3259 


3260 


3261 


3262 


3263 


CC_ 


3264 


3265 


3266 


3267 


3268 


3269 


3270 


3271 


3272 


3273 


3274 


3275 


3276 


3277 


3278 


3279 


CD 


3280 


3281 


3282 


3283 


3284 


3285 


3286 


3287 


3288 


3289 


3290 


3291 


3292 


3293 


3294 


3295 


CE_ 


3296 


3297 


3298 


3299 


3300 


3301 


3302 


3303 


3304 


3305 


3306 


3307 


3308 


3309 


3310 


3311 


CF_ 


3312 


3313 


3314 


3315 


3316 


3317 


3318 


3319 


3320 


3321 


3322 


3323 


3324 


3325 


3326 


3327 


D0_ 


3328 


3329 


3330 


3331 


3332 


3333 


3334 


3335 


3336 


3337 


3338 


3339 


3340 


3341 


3342 


3343 


Dl_ 


3344 


3345 


3346 


3347 


3348 


3349 


3350 


3351 


3352 


3353 


3354 


3355 


3356 


3357 


3358 


3359 


D2_ 


3360 


3361 


3362 


3363 


3364 


3365 


3366 


3367 


3368 


3369 


3370 


3371 


3372 


3373 


3374 


3375 


D3_ 


3376 


3377 


3378 


3379 


3380 


3381 


3382 


3383 


3384 


3385 


3386 


3387 


3388 


3389 


3390 


3391 


D4_ 


3392 


3393 


3394 


3395 


3396 


3397 


3398 


3399 


3400 


3401 


3402 


3403 


3404 


3405 


3406 


3407 


D5_ 


3408 


3409 


3410 


3411 


3412 


3413 


3414 


3415 


3416 


3417 


3418 


3419 


3420 


3421 


3422 


3423 


D6_ 


3424 


3425 


3426 


3427 


3428 


3429 


3430 


3431 


3432 


3433 


3434 


3435 


3436 


3437 


3438 


3439 


D7_ 


3440 


3441 


3442 


3443 


3444 


3445 


3446 


3447 


3448 


3449 


3450 


3451 


3452 


3453 


3454 


3455 


D8_ 


3456 


3457 


3458 


3459 


3460 


3461 


3462 


3463 


3464 


3465 


3466 


3467 


3468 


3469 


3470 


3471 


D9_ 


3472 


3473 


3474 


3475 


3476 


3477 


3478 


3479 


3480 


3481 


3482 


3483 


3484 


3485 


3486 


3487 


DA_ 


3488 


3489 


3490 


3491 


3492 


3493 


3494 


3495 


3496 


3497 


3498 


3499 


3500 


3501 


3502 


3503 


DB_ 


3504 


3505 


3506 


3507 


3508 


3509 


3510 


3511 


3512 


3513 


3514 


3515 


3516 


3517 


3518 


3519 


DC„ 


3520 


3521 


3522 


3523 


3524 


3525 


3526 


3527 


3528 


3529 


3530 


3531 


3532 


3533 


3534 


3535 


DD_ 


3536 


3537 


3538 


3539 


3540 


3541 


3542 


3543 


3544 


3545 


3546 


3547 


3548 


3549 


3550 


3551 


DE_ 


3552 


3553 


3554 


3555 


3556 


3557 


3558 


3559 


3560 


3561 


3562 


3563 


3564 


3565 


3566 


3567 


DF_ 


3568 


3569 


3570 


3571 


3572 


3573 


3574 


3575 


3576 


3577 


3578 


3579 


3580 


3581 


3582 


3583 



F-4 370-XA Principles of Operation 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


E0_ 


3584 


3585 


3586 


3587 


3588 


3589 


3590 


3591 


3592 


3593 


3594 


3595 


3596 


3597 


3598 


3599 


El_ 


3600 


3601 


3602 


3603 


3604 


3605 


3606 


3607 


3608 


3609 


3610 


3611 


3612 


3613 


3614 


3615 


E2_ 


3616 


3617 


3618 


3619 


3620 


3621 


3622 


3623 


3624 


3625 


3626 


3627 


3628 


3629 


3630 


3631 


E3_ 


3632 


3633 


3634 


3635 


3636 


3637 


3638 


3639 


3640 


3641 


3642 


3643 


3644 


3645 


3646 


3647 


E4_ 


3648 


3649 


3650 


3651 


3652 


3653 


3654 


3655 


3656 


3657 


3658 


3659 


3660 


3661 


3662 


3663 


E5_ 


3664 


3665 


3666 


3667 


3668 


3669 


3670 


3671 


3672 


3673 


3674 


3675 


3676 


3677 


3678 


3679 


E6_ 


3680 


3681 


3682 


3683 


3684 


3685 


3686 


3687 


3688 


3689 


3690 


3691 


3692 


3693 


3694 


3695 


E7_ 


3696 


3697 


3698 


3699 


3700 


3701 


3702 


3703 


3704 


3705 


3706 


3707 


3708 


3709 


3710 


3711 


E8_ 


3712 


3713 


3714 


3715 


3716 


3717 


3718 


3719 


3720 


3721 


3722 


3723 


3724 


3725 


3726 


3727 


E9_ 


3728 


3729 


3730 


3731 


3732 


3733 


3734 


3735 


3736 


3737 


3738 


3739 


3740 


3741 


3742 


3743 


EA_ 


3744 


3745 


3746 


3747 


3748 


3749 


3750 


3751 


3752 


3753 


3754 


3755 


3756 


3757 


3758 


3759 


EB_ 


3760 


3761 


3762 


3763 


3764 


3765 


3766 


3767 


3768 


3769 


3770 


3771 


3772 


3773 


3774 


3775 


EC_ 


3776 


3777 


3778 


3779 


3780 


3781 


3782 


3783 


3784 


3785 


3786 


3787 


3788 


3789 


3790 


3791 


ED_ 


3792 


3793 


3794 


3795 


3796 


3797 


3798 


3799 


3800 


3801 


3802 


3803 


3804 


3805 


3806 


3807 


EE_ 


3808 


3809 


3810 


3811 


3812 


3813 


3814 


3815 


3816 


3817 


3818 


3819 


3820 


3821 


3822 


3823 


EF_ 


3824 


3825 


3826 


3827 


3828 


3829 


3830 


3831 


3832 


3833 


3834 


3835 


3836 


3837 


3838 


3839 


F0_ 


3840 


3841 


3842 


3843 


3844 


3845 


3846 


3847 


3848 


3849 


3850 


3851 


3852 


3853 


3854 


3855 


Fl_ 


3856 


3857 


3858 


3859 


3860 


3861 


3862 


3863 


3864 


3865 


3866 


3867 


3868 


3869 


3870 


3871 


F2_ 


3872 


3873 


3874 


3875 


3876 


3877 


3878 


3879 


3880 


3881 


3882 


3883 


3884 


3885 


3886 


3887 


F3_ 


3888 


3889 


3890 


3891 


3892 


3893 


3894 


3895 


3896 


3897 


3898 


3899 


3900 


3901 


3902 


3903 


F4_ 


3904 


3905 


3906 


3907 


3908 


3909 


3910 


3911 


3912 


3913 


3914 


3915 


3916 


3917 


3918 


3919 


F5_ 


3920 


3921 


3922 


3923 


3924 


3925 


3926 


3927 


3928 


3929 


3930 


3931 


3932 


3933 


3934 


3935 


F6_ 


3936 


3937 


3938 


3939 


3940 


3941 


3942 


3943 


3944 


3945 


3946 


3947 


3948 


3949 


3950 


3951 


F7_ 


3952 


3953 


3954 


3955 


3956 


3957 


3958 


3959 


3960 


3961 


3962 


3963 


3964 


3965 


3966 


3967 


F8_ 


3968 


3969 


3970 


3971 


39/2 


3973 


3974 


3975 


3976 


3977 


3978 


3979 


3980 


3981 


3982 


3983 


F9_ 


3984 


3985 


3986 


3987 


3988 


3989 


3990 


3991 


3992 


3993 


3994 


3995 


3996 


3997 


3998 


3999 


FA_ 


4000 


4001 


4002 


4003 


4004 


4005 


4006 


4007 


4008 


4009 


4010 


4011 


4012 


4013 


4014 


4015 


FB_ 


4016 


4017 


4018 


4019 


4020 


4021 


4022 


4023 


4024 


4025 


4026 


4027 


4028 


4029 


4030 


4031 


FC_ 


4032 


4033 


4034 


4035 


4036 


4037 


4038 


4039 


4040 


4041 


4042 


4043 


4044 


4045 


4046 


4047 


FD_ 


4048 


4049 


4050 


4051 


4052 


4053 


4054 


4055 


4056 


4057 


4058 


4059 


4060 


4061 


4062 


4063 


FE_ 


4064 


4065 


4066 


4067 


4068 


4069 


4070 


4071 


4072 


4073 


4074 


4075 


4076 


4077 


4078 


4079 


FF_ 


4080 


4081 


4082 


4083 


4084 


4085 


4086 


4087 


4088 


4089 


4090 


4091 


4092 


4093 


4094 


4095 



Appendix F. Hexadecimal Tables F-5 



Conversion Table: Hexadecimal and Decimal Integers 



HALFWORD 


HALFWORD 


BYTE 


BYTE 


BYTE 


BYTE 


BITS: 0123 


4567 


0123 


4567 


0123 


4567 


0123 


4567 


Hex 


Decimal 


Hex 


Decimal 


Hex 


Decimal 


Hex 


Decimal 


Hex 


Decimal 


Hex 


Decimal 


Hex 


Decimal 


Hex 


Decimal 


















































1 


268,435,456 


1 


16,777,216 


1 


1,048,576 


1 ' 


65,536 


1 


4,096 


1 


256 


1 


16 


1 


1 


2 


536,870,912 


2 


33,554,432 


2 


2,097,152 


2 


131,072 


2 


8,192 


2 


512 


2 


32 


2 


2 


3 


«05, 306,368 


3 


50,331,648 


3 


3,145,728 


3 


196,608 


3 


12,288 


3 


768 


3 


48 


3 


3 


4 


1,073,741,824 


4 


67,108,864 


4 


4.194.304 


4 


262.144 


4 


16.384 


4 


1.024 


4 


64 


4 


4 


5 


1,342,177,280 


5 


83,886,080 


5 


5,242,880 


5 


327,680 


5 


20,480 


5 


1,280 


5 


80 


5 


5 


6 


1,610,612,736 


6 


100,663,296 


6 


6,291,456 


6 


393,216 


6 


24,576 


6 


1,536 


6 


96 


6 


6 


7 


1,879,048,192 


7 


117,440,512 


7 


7,340,032 


7 


458,752 


7 


28,672 


7 


1,792 


7 


112 


7 


7 


8 


2,147,483,648 


8 


134,217,728 


8 


8,388,608 


8 


524,288 


8 


32,768 


8 


2,048 


8 


128 


8 


8 


* 


2,415,919,104 


9 


150,994,944 


9 


^437,184 


9 


589,824 


9 


36,864 


9 


2,304 


9 


144 


9 


9 


A 


2,684,354,560 


A 


167,772,160 


A 


10,485,760 


A 


655,360 


A 


40,960 


A 


2,560 


A 


160 


A 


10 


B 


2.952.790.016 


B 


184,549,376 


B 


11.534.336 


B 


720,896 


B 


45,056 


B 


2,816 


B 


176 


B 


11 


C 


3,221,225,472 


C 


201 ,326,592 


C 


12,582,912 


C 


786,432 


C 


49.152 


C 


3.072 


C 


192 


C 


12 


D 


3,489,660,928 


D 


218,103,808 


D 


13,631,488 


D 


851.968 


D 


53,248 


D 


3,328 


D 


208 


D 


13 


E 


3,758,096,384 


E 


234,881,024 


E 


14,680,064 


E 


917,504 


E 


57,344 


E 


3,584 


E 


224 


E 


14 


F 


4,026,531,846 


F 


251,658,240 


F 


15,728,640 


F 


983,040 


F 


61,440 


F 


3,840 


F 


240 


F 


15 


8 


7 


6 


5 


4 


3 


2 


1 



TO CONVERT HEXADECIMAL TO DECIMAL 

1 . Locate the column of decimal numbers corresponding to 
the left-most digit or letter of the hexadecimal; select 
from this column and record the number that corresponds 
to the position of the hexadecimal digit or letter. 

2 . Repeat step 1 for the next (second from the left) 
position. 

3. Repeat step 1 for the units (third from the left) 
position . 

4. Add the numbers selected from the table to form the 
decimal number. 



TO CONVERT DECIMAL TO HEXADECIMAL 

1 . (a) Select from the table the highest decimal number 
that is equal to or less than the number to be con- 
verted . 

(b) Record the hexadecimal of the column containing 
the selected number. 

(c) Subtract the selected decimal from the number to 
be converted. 

2. Using the remainder from step 1(c) repeat all of step 1 
to develop the second position of the hexadecimal 
(and a remainder) . 

3. Using the remainder from step 2 repeat all of step 1 to 
develop the units position of the hexadecimal . 

4. Combine terms to form the hexadecimal number. 



EXAMPLE 




Conversion of 




Hexadecimal Value 


D34 


1. D 


3328 


2. 3 


48 


3. 4 


4 


4. Decimal 


3380 



EXAMPLE 




Conversion of 
Decimal Value 


3380 


1. D 


-3328 
52 


2. 3 


-48 

4 


3. 4 

4. Hexadecimal 


-4 


D34 



To convert integer numbers greater than the capacity of 
table, use the techniques below: 

HEXADECIMAL TO DECIMAL 

Successive cumulative multiplication from left to right, 
adding units position . 



Example: D34 lo = 3380 10 


D = 13 

_*!&_ 
208 

3 = + 3 

211 

xl6 

3376 

4 = +4 

3380 


DECIMAL TO HEXADECIMAL 




Divide and collect the remainder 


in reverse order. 


Example: 3380. q= X.. 




16 |3380 _ 


remainder 


16 1211 ^^"-^ 


4 a 


16 113 _^"-* 


-3 






D 


3380 10 =D34 16 



POWERS OF 16 TABLE 



Example: 268,435,456, = (2.68435456 x 10 8 ) ]0 = 1000 0000 ]6 = (10 7 ) 16 



16" 


n 


1 





16 


1 


256 


2 


4 096 


3 


65 536 


4 


1 048 576 


5 


16 777 216 


6 


268 435 456 


7 


4 294 967 296 


8 


68 719 476 736 


9 


1 099 51 1 627 776 


10 = A 


17 592 186 044 416 


11 =B 


281 474 976 710 656 


12=C 


4 503 599 627 370 496 


13 = D 


72 057 594 037 927 936 


14 = E 


.1 152 921 504 606 846 976 

v ; v . 


15 = F 



Decimal Values 
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Conversion Table: Hexadecimal and Decimal Fractions 



HALFWORD 


BYTE 


BYTE 


BITS 


0123 


4567 


0123 


4567 


Hex 


Decimal 


Hex 


Decimal 


Hex 


Decimal 


Hex 




Decima 


Equivalent 




.0 


.0000 


.00 


.0000 


0000 


.000 


.0000 


0000 


0000 


.0000 


.0000 


0000 


0000 


0000 


.1 


.0625 


.01 


.0039 


0625 


.001 


.0002 


4414 


0625 


.0001 


.0000 


1525 


8789 


0625 


.2 


.1250 


.02 


.0078 


1250 


.002 


.0004 


8828 


1250 


.0002 


.0000 


3051 


7578 


1250 


.3 


.1875 


.03 


.0117 


1875 


.003 


.0007 


3242 


1875 


.0003 


.0000 


4577 


6367 


1875 


.4 


.2500 


.04 


.0156 


2500 


.004 


.0009 


7656 


2500 


.0004 


.0000 


6103 


5156 


2500 


.5 


.3125 


.05 


.0195 


3125 


.005 


.0012 


2070 


3125 


.0005 


.0000 


7629 


3945 


3125 


.6 


.3750 


.06 


.0234 


3750 


.006 


.0014 


6484 


3750 


.0006 


.0000 


9155 


2734 


3750 


.7 


.4375 


.07 


.0273 


4375 


.007 


.0017 


0898 


4375 


.0007 


.0001 


0681 


1523 


4375 


.8 


.5000 


.08 


.0312 


5000 


.008 


.0019 


5312 


5000 


.0008 


.0001 


2207 


0312 


5000 


.9 


.5625 


.09 


.0351 


5625 


.009 


.0021 


9726 


5625 


.0009 


.0001 


3732 


9101 


5625 


.A 


.6250 


.0A 


.0390 


6250 


.00 A 


.0024 


4140 


6250 


.000 A 


.0001 


5258 


7890 


6250 


.B 


.6875 


.OB 


.0429 


6875 


.00B 


.0026 


8554 


6875 


.000B 


.0001 


6784 


6679 


6875 


.C 


.7500 


,0C 


.0468 


7500 


.OOC 


.0029 


2968 


7500 


.OOOC 


.0001 


8310 


5468 


7500 


.D 


.8125 


.0D 


.0507 


8125 


.00D 


.0031 


7382 


8125 


.OOOD 


.0001 


9836 


4257 


8125 


.E 


.8750 


.OE 


.0546 


8750 


.00E 


.0034 


1796 


8750 


.OOOE 


.0002 


1362 


3046 


8750 


.F 


.9375 


.OF 


.0585 


9375 


.OOF 


.0036 


6210 


9375 


.OOOF 


.0002 


2888 


1835 


9375 


1 


2 


3 


4 



TO CONVERT .ABC HEXADECIMAL TO DECIMAL 

Find .A in position 1 .6250 

Find .OB in position 2 .0429 6875 

Find .OOC in position 3 .0029 2968 7500 

.ABC Hex is equal to .6708 9843 7500 



TO CONVERT .13 DECIMAL TO HEXADECIMAL 



1 . Find .1250 next lowest to 

subtract 

2. Find .0039 0625 next lowest to 

3. Find .0009 7656 2500 

4. Find .0001 0681 1523 4375 



.1300 
-.1250 

.0050 0000 
-.0039 0625 

.0010 9375 0000 
-.0009 7656 2500 



= .2 Hex 
= .01 
= .004 



.0001 1718 7500 0000 
-.0001 0681 1523 4375 = .0007 



5. .13 Decimal is approximately equal to 



0000 1037 5976 5625 = .21 47 Hex 

* 



To convert fractions beyond the capacity of table, use techniques below: 



HEXADECIMAL FRACTION TO DECIMAL 

Convert the hexadecimal fraction to its decimal equivalent using the same 
technique as for integer numbers. Divide the results by 16 n (n is the 
number of fraction positions). 
Example: .8A7 = .540771 \q 

8A7 16 = 2215,0 ,540771 

163 = 4096 409612215.000000 



DECIMAL FRACTION TO HEXADECIMAL 

Collect integer parts of product in the order of calculation. 
Example: .5408,0 = .8A7,6 



.5408 
x!6 

8 -*- (J. 6528 
x!6 

A-*- 0.4448 
x16 

7 -*- Q.H68 
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Hexadecimal Addition and Subtraction Table 





1 


2 


3 


4 


E 
5 


xomple: 
6 


6 + 2 = 

7 


8, 8-J 
8 


!=6, a 
9 


nd8-< 
A 


= 2 

B 


C 


D 


E 


F 


1 


02 


03 


04 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


2 


03 


04 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


3 


04 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


4 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


5 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


6 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


7 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


8 


09 


OA 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


9 


0A 


OB 


OC 


OD 


OE 


OF 


10 


11 


32 


13 


14 


15 


16 


17 


18 


A 


OB 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


B 


OC 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


C 


OD 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


IB 


D 


OE 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


IB 


1C 


E 


OF 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


IB 


1C 


ID 


F 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


1A 


IB 


1C 


ID 


IE 



Hexadecimal Multiplication Table 

Example: 2 x 4 = 08, Fx2=lE 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


1 


01 


02 


03 


04 


05 


06 


07 


08 


09 


OA 


OB 


OC 


OD 


OE 


OF 


2 


02 


04 


06 


08 


OA 


OC 


OE 


10 


12 


14 


16 


18 


1A 


1C 


IE 


3 


03 


06 


09 


OC 


OF 


12 


15 


18 


IB 


IE 


21 


24 


27 


2A 


2D 


4 


04 


08 


OC 


10 


14 


18 


1C 


20 


24 


28 


2C 


30 


34 


38 


3C 


5 


05 


OA 


OF 


14 


19 


IE 


23 


28 


2D 


32 


37 


3C 


41 


46 


4B 


6 


06 


OC 


12 


18 


IE 


24 


2A 


30 


36 


3C 


42 


48 


4E 


54 


5A 


7 


07 


OE 


15 


1C 


23 


2A 


31 


38 


3F 


46 


4D 


54 


5B 


62 


69 


8 


08 


10 


18 


20 


28 


30 


38 


40 


48 


50 


58 


60 


68 


70 


78 


9 


09 


12 


IB 


24 


2D 


36 


3F 


48 


51 


5A 


63 


6C 


75 


7E 


87 


A 


OA 


14 


IE 


28 


32 


3C 


46 


50 


5A 


64 


6E 


78 


82 


8C 


96 


B 


OB 


16 


21 


2C 


37 


42 


4D 


58 


63 


6E 


79 


84 


8F 


9A 


A5 


C 


OC 


18 


24 


30 


3C 


48 


54 


60 


6C 


78 


84 


90 


9C 


A8 


*B4 


D 


OD 


1A 


27 


34 


41 


4E 


5B 


68 


75 


82 


8F 


9C 


A9 


B6 


C3 


E 


OE 


1C 


2A 


38 


46 


54 


62 


70 


7E 


8C 


9A 


AS 


B6 


C4 


D2 


F 


OF 


IE 


2D 


3C 


4B 


5A 


69 


78 


87 


96 


A5 


B4 


C3 


D2 


El 
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APPENDIX G. EBCDIC CHART 



EXTENDED BINARY-CODED-DECIMAL INTER- 
CHANGE CODE (EBCDIC) 



The 256-position EBCDIC table shows 
graph i c-character, control -character, 
and f ormatti ng-character representations 
for EBCDIC. The bit-position numbers, 
bit patterns, hexadecimal represent- 
ations, and card-hole patterns for these 
and other possible EBCDIC characters are 
also shown. 

To find the card-hole pattern for most 
characters, partition the table into 
four blocks, as follows: 



1 3 

2 4 



Block 1: Zone punches at top of table; 

digit punches at left 
Block 2: Zone punches at bottom of 

table; digit punches at left 
Block 3: Zone punches at top of table; 

digit punches at right 
Block 4; Zone punches at bottom of 

table; digit punches at right 



Fifteen posit 
exceptions to 
Each such pos 
ci rcled number 
of the box 
card-hole patt 
are shown 
Bit-position n 
hexadecimal r 
positions are 



ions in th 

the above 

i ti on is in 

in the upper 

for that po 

erns for the 

beneath 
umbers, bit 
epresentati on 
found i n the 



e table are 
arrangement, 
dicated by a 
right corner 
sition. The 
se positions 
the table, 
patterns, and 
s for these 
usual manner. 



Appendix G. EBCDIC Chart G-l 



ThQ EBCDIC table shows 94 graphic- 
character positions. Some products have 
used an 88-character, 63-character, or 
62-character subset of these graphic 
characters. 

The 94-character set consists of all 
graphic characters shown in the EBCDIC 
table. This character set can be used 
for interchange with other systems; 
those systems may use codes, other than 
EBCDIC, which have 94 graphic 
characters. 

An 88-character set that has been used 
consists of the 94-character set with 
the graphic characters at 6A, 79, Al, 
CO, DO, and EO hex omitted. This char- 
acter set has been used for 44-key 
keyboard applications which require both 
uppercase and lowercase alphabetic chai — 
acters. 

A 63-character set that has been used 
consists of the 94-character set with 
the lowercase alphabetic characters 
omitted and with the graphic characters 
at 6A, 79, Al, CO, and DO hex omitted. 
This character set has been used for 
interchange with other systems; those 
systems may have used codes, other than 
EBCDIC, which have 63 graphic 
characters. 

A 62-character set that has been used 
consists of the 63-character set with 
the graphic character at EO hex omitted. 
This character set has been used for 
44-key keyboard applications which do 
not require lowercase alphabetic charac- 
ters. 



Thirteen positions (4A, 4F, 5A, 5B, 5F, 
6A, 79, 7B, 7C, Al, CO, DO, and EO hex) 
are defined in the table as Data Proc- 
essing National Use positions. Each 
such position contains a triangle in the 
top left corner ( ) of the box for 
that position. The graphic characters 
provided in these positions on printing 
and display devices may differ from one 
language to another or from one country 
to another. The characters provided for 
use in data-processing applications by 
the English (U.S.) version of EBCDIC are 
shown in the table. 

The other graphic characters shown in 
the EBCDIC table are provided for data- 
processing applications in the English 
(U.S.) version of EBCDIC and in addi- 
tional versions of EBCDIC in other 
languages which use a Latin-based alpha- 
bet. Products designed for data- 
processing applications in a language 
which does not use a Latin-based alpha- 
bet support character sets meeting the 
particular requirements of that 
language. 

Word-processing products normally 
support a character set slightly differ- 
ent from the one shown in the table. 
Additionally, a number of application 
areas (such as printing and publishing, 
magnetic-ink character recognition, and 
some programming languages) also require 
unique character-set support. 

Some examples of the use of the EBCDIC 
table are shown in the following figure: 



Character 


Type 


Bit Pattern 


Hex 


Hole Pattern 


Zone Punches 


Digit Punches 


SEL 


Control Character 


00 00 0100 


04 


12-9J-4 


% 


Special Graphic 


01 10 1100 


6C 


0-8-4 


R 


Upper Case 


11 01 1001 


D9 


11 1-9 


a 


Lower Case 


10 00 0001 


81 


12-0i- 1 




Control Character, 
function not yet 
assigned 


00 1 1 0000 


30 


12-11 -0-91-8-1 

1 
1 



Bit Positions 
01 23 4567 
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00 


01 


10 


11 


1 Bit Positions 0,1 


"5> 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


00 


01 


10 


11 


1 Bit Positions 2,3 


iv 5 
^ 1 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


c 


D 


E 


F 


1 First Hexadecimal Digit 


■°- I 


u 








12 


12 




12 


12 


12 




12 


12 










* I 2 
1 £ * 




ilii 








U 


1! 


11 




11 


11 


11 




11 










































8 1 t 












































t $ & 


































Digit Punches 
) / 


S i/> o 


9 


iBE 


9 


^^S 


9 


SSBB 


SB 


9 










p| 








0000 





8-1 


n3 

NUL 


© 

DLE 


® 
DS W 


© 


© 
SP W 


s © 


.© 


© 












piPl 


r© 


® 




«-:!■■■' 




0001 


11 


1 


SOH 


DC1 


SOS 




RSP 




/® 








F~ 




A 


J 


® 


1 






































NSP 








0010 


2\ 


Pi 


STX 


DC2 


FS 


SYN 










b 


k 


s 




B 


K 


S 


2 


2 




0011 


3 


3 


ETX 


DC3 


WUS 


IR 










c 


I 


t 




C 


L 


T 


3 


3 




0100 


4 


4 


SEL 


RES/ 
ENP 


BYP/ 
INP 


PP 










d 


m 


« 




D 


M 


U 


4 


• .. 4".' 




0101 


s\ 


5 


HT 


NL 


LF 


TRN 










e 


n 


V 




E 


N 


V 


5 


■ 5 




0110 


6 


6 


RNL 


BS 


ETB 


NBS 










f 


o 


w 




F 


O 


W 


6 


6 




0111 


7 


7 


DEL 


POC 


ESC 


EOT 










9 


P 


X 




G 


P 


X 


7 


7 




1000 


8 


8 


GE 


CAN 


SA 


SBS 










h 


q 


y 




H 


Q 


Y 


8 


8 
























f, 






















1001 


9 


8-1 


SPS 


EM 


SFE 


IT 










i 


r 


z 




1 


R 


Z 


9 


9 


















V 


w 


r,® 
























1010 


A 


8-2 


RPT 


UBS 


SM/SW 


RFF 


« 


i 












SHY 








8»2 




















w 




v 






















1011 


B 


8-3 


VT 


CU1 


CSP 


CU3 




$ 


' 


# 


















8-3 
























r 






















1100 


C 


8-4 


FF 


IFS 


MFA 


DC4 


< 


* 


% 


@ 


















8-4 




1101 


D 


i-S 


CR 


IGS 


ENQ 


NAK 


( 


) 





■ 
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Appendix G. EBCDIC Chart 6-3 



INDEX 



A (ADD) binary instruction 7-8 

absolute address 3-4 

absolute storage 3-4 

access-control bits in storage key 3-8 

access exceptions 6-25*6-29 

priority of 6-29 

recognition of 6-25 
access key 3-9 

for channel-program execution 
3-10,15-22 

for channel-subsystem monitoring 
3-10,17-4 

for CPU 3-10 
access to storage 5-22 

(See also reference) 
acti ve 

device 16-15 

subchannel 16-15 
active allegiance 15-12 
active communication 15-12 
activity-control field (SCSW) 16-13 

following TEST SUBCHANNEL 14-16 
AD (ADD NORMALIZED) instruction 9-6 

example A-36 
ADD (A,AR) binary instructions 7-8 
ADD DECIMAL (AP) instruction 8-5 

example A-30 
ADD HALFWORD (AH) instruction 7-8 

example A-8 
ADD LOGICAL (AL,ALR) instructions 7-9 
ADD NORMALIZED ( AD, ADR, AE, AER, AXR) 
instructions 9-6 

example A-36 
ADD UNNORMALIZED ( AU, AUR, AW, AWR) 
instructions 9-7 

example A-36 
address 3-2 

absolute 3-4 

arithmetic 3-5,5-5 

unsigned binary 7-3 

base (See base address) 

branch (See branch address) 

channel-program (See channel-program 
address) 

compari son 12-1 

controls for 12-1 
effect on CPU state 4-2 

CPU (See CPU address) 

data (I/O) (See data address) 

effective (See effective address) 

failing-storage (See failing-storage 
address) 

format 3-2 

generation 5-5 

for storage addressing 3-6 

I/O 13-5 

instruction (See instruction 
address) 

invalid 6-13 

logical (See logical address) 

numbering of for byte locations 3-2 

PER (See PER address) 

prefixing (See prefix) 

primary virtual (See primary virtual 
address) 

real 3-4 



secondary virtual (See secondary 

virtual address) 
size of 3-5 

controlled by addressing mode 5-5 
storage 3-2 

summary information 3-36 
translation (See dynamic address 

translation, prefix) 
types 3-4 
virtual 3-5 

wraparound (See wraparound) 
24-bit and 31-bit D-1,3-5 

in branch address generation 5-6 
in operand address generation 5-6 
31-bit real and absolute D-l 
address-limit checking (I/O) 17-14 

effect of I/0-system reset on 17-10 
limit mode (bits in PMCW) 15-3 
address-limit-checking control (I/O) 
15-22,16-11 

used for IPL 17-12 
address space 3-13 
control bit 
in PSW 4-6 

use in address translation 3-22 
created by DAT 3-21 
number (See ASN) 
addressing exception 6-13 

as an access exception 6-25,6-29 
addressing mode 5-5 

bit in entry-table entry 5-20 

bit in PSW 4-6 

effect on address size 3-6 

effect on operand-address generation 

5-6 
effect on sequential 

instruction-address generation 5-5 
effect on wraparound 3-6 
in branch address generation 5-6 
i n examples A-8 

in operand address generation 5~6 
programming note describing use of 

5-8 
set by BRANCH AND SAVE AND SET MODE 

instruction 7-11 
set by BRANCH AND SET MODE instruc- 
tion 7-12 
ADR (ADD NORMALIZED) instruction 9-6 
AE (ADD NORMALIZED) instruction 9-6 

example A-36 
AER (ADD NORMALIZED) instruction 9-6 
AFT (ASN first table) 3-15 
AFTE (ASN-first-table entry) 3-15 
AFTO (ASN-first-table origin) 3-15 
AFX (ASN-first-table index) 3-14 
invalid bit 3-15 
translation exception 6-15 
AH (ADD HALFWORD) instruction 7-8 

example A-8 
AKM (authorization key mask) 5-19 
AL (ADD LOGICAL) instruction 7-9 
alert (class of machine-check condition) 

11-11 
alert interruption condition (I/O) 16-4 
alert-status bit (I/O) 16-16 
allegi ance 

active 15-12 
channel-path 15-11 
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dedicated 15-12 

effect on CLEAR SUBCHANNEL of 15-11 
working 15-11 
allowed interruptions 6-5 
ALR (ADD LOGICAL) instruction 7-9 
alter-and-di splay controls 12-2 
alterati on 

general-register (PER event) 4-15 
storage (PER event) 4-15 
AND (N,NC,NI,NR) instructions 7-9 

examples A~8 
AP (ADD DECIMAL) instruction 8-5 

example A-30 
AR (ADD) binary instruction 7-8 
architectural mode 1-1 
compatibility 1-3 
indication of 12-2 
selection of by IML controls 12-3 
selection of by manual controls 12-2 
ari thmeti c 

binary 7-3 

examples A-2 
decimal 8-2 

examples A~5,A~30 
floating-point 9-1 

examples A-5,A-36 
logical (unsigned binary) 7-3 
examples A-4 
ASCII character code, handled by archi- 
tecture iv 
ASN (address-space number) 3-13 
authorization 3-18 
first table (AFT) 3-15 
index (AFX) 3-14 
origin (AFTO) 3-15 
in entry-table entry 5-20 
second table (AST) 3-15 
index (ASX) 3-14 
origin (ASTO) 3-15 
trace-control bit 4-8 
translation 3~14 
exceptions 6-31 
specification exception 6-15 
translation-control bit 3-14,5-17 
assembler language A-7 

instruction formats in (See instruc- 
tion lists and page numbers in 
Appendix B) 
assigned storage locations 3-38 

comparison of 370-XA with System/370 
D-9 
AST (ASN second table) 3-15 
ASTE (ASN-second-table entry) 3-15 
ASTO (ASN-second-table origin) 3-15 
ASX (ASN-second-table index) 3-14 
invalid bit 3-15 
translation exception 6-15 
AT (authority table) 5-17 
ATL (authority-table length) 3-15 
ATO (authority-table origin) 3-15 
attached segment-table or page-table 

entry 3-31 
attachment of I/O devices 13-3 
attention (device status) 16-23 
AU (ADD UNNORMALIZED) instruction 9-7 

example A-36 
AUR (ADD UNNORMALIZED) instruction 9-7 
authority 3-18 
authority table (AT) 5-17 

designation 3-15 
authori zati on 

index (AX) 3-18,5-17 
key mask (AKM) 5-19 
mechanisms 5-15 



summary of 5-18 
auxiliary storage 3-2,3-21 
availability (characteristic of a 

system) 1-5 
AW (ADD UNNORMALIZED) instruction 9-7 
AWR (ADD UNNORMALIZED) instruction 9-7 
AX (authorization index) 5-17 
AXR (ADD NORMALIZED) instruction 9-6 



B 

B field of instruction 5-5 

backed-up bit (machine-check condition) 

11-18 
backup, processing (synchronous 

machine-check condition) 11-18 
BAL (BRANCH AND LINK) instruction 7-10 

examples A-9 
BALR (BRANCH AND LINK) instruction 7-10 

examples A-9 
BAS (BRANCH AND SAVE) instruction 7-11 

example A-9 
base address 5-5 

register for 2-3 
basic I/O functions 15-2 
basic operator facilities 12-1 
basic sense command 15-39 
BASR (BRANCH AND SAVE) instruction 7-11 

example A-9 
BASSM (BRANCH AND SAVE AND SET MODE) 
instruction 7-11 
example A-9 
BC (BRANCH ON CONDITION) instruction 
7-12 

example A-10 
BCR (BRANCH ON CONDITION) instruction 

7-12 
BCT (BRANCH ON COUNT) instruction 7-13 

example A-ll 
BCTR (BRANCH ON COUNT) instruction 7-13 

example A-ll 
bimodal addressing D-1,5-5 

(See also addressing mode) 
bi nary 

(See also fixed point) 
arithmetic 7-3 

examples A-2 
negative zero 7-2 
number representation 7-2 

examples A-2 
overflow 7-3 

example A-2 
sign bit 7-2 
binary-to-decimal conversion 7-24 

example A-16 
bit 3-2 

numbering of within a group of bytes 
3-2 
block-concurrent storage references 

5-29 
block of I/O data 15-21 
block of storage 3-4 
(See also page) 

testing for usability of 10-44 
borrow 7-45 
boundary alignment 3-3 

for instructions 5-2 
branch address 5-6 

in trace entry 4-10 
BRANCH AND LINK (BAL, BALR) instructions 
7-10 

examples A-9 
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BRANCH AND SAVE (BAS,BASR) instructions 
7-11 

examples A-9 
BRANCH AND SAVE AND SET MODE (BASSM) 
instruction 7-11 
examples A-9 
BRANCH AND SET MODE (BSM) instruction 
7-12 

examples A-9 
BRANCH ON CONDITION (BCBCR) 
instructions 7-12 
example A-10 
BRANCH ON COUNT (BCT,BCTR) instructions 
7-13 

example A-ll 
BRANCH ON INDEX HIGH (BXH) instruction 
7-13 

examples A-ll 
BRANCH ON INDEX LOW OR EQUAL (BXLE) 
instruction 7-14 
examples A-12 
branch-trace-control bit 4-8 
branchi ng 

branch address generation 5-6 
in a channel program (See TIC) 
to perform decision making, loop 
control, and subroutine linkage 5-7 
BSM (BRANCH AND SET MODE) instruction 
7-12 

example A-9 
buffer storage (cache) 3-2 
burst mode (channel-path operation) 

13-3 
bus-out check (bit in I/O sense data) 

15-39 
busy 

as device status (I/O) 16-25 
control unit 16-24,16-25 
in I/O operations 13-7 
in SIGNAL PROCESSOR 4-32 
BXH (BRANCH ON INDEX HIGH) instruction 
7-13 

examples A-ll 
BXLE (BRANCH ON INDEX LOW OR EQUAL) 
instruction 7-14 
examples A-12 
bypassing POST and WAIT A-42 
byte 3-2 

numbering of in storage 3-2 
byte index (BX) 3-22 

byte-multiplex mode (channel-path opera- 
tion) 13-3 



C (COMPARE) binary instruction 7-14 

cache 3-2 

carry 7-3 

CBC (checking-block code) 11-2 

invalid 11-2 

in registers 11-9 

in storage 11-6 

in storage keys 11-7 

neai — valid 11-2 

valid 11-2 
CCC (channel-control check) 16-31 
CCW (channel-command word) 15-23 

address of 15-23,16-18 

byte count in 15-25 

chaining 15-27 

check (in subchannel logout) 16-37 

command codes (See commands) 

contents of 15-24 



current 15-24 

designation of storage area in 

15-24,15-26 
format control 15-22,16-10 

used for IPL 17-12 
format-0 and format-1 15-24 
IDA flag in 15-25 
in IPL (assigned storage locations) 

3-38 
indirect data addressing used in 

13-7,15-32 
invalid format of 16-29 
invalid specification of 16-28 
PCI flag in 15-25 
prefetch control in 15-22,16-10 

used for IPL 17-12 
prefetching 15-29 
retry of (See command retry) 
role in I/O operations of 13-6 
skip flag in 15-25 
suspend flag in 15-25 
CD (COMPARE) floating-point instruction 

9-8 
CDR (COMPARE) floating-point instruction 
9-8 

examples A-37 
CDS (COMPARE DOUBLE AND SWAP) instruc- 
tion 7-19 

examples A-40 
CE (COMPARE) floating-point instruction 

9-8 
central processing unit (See CPU) 
CER (COMPARE) floating-point instruction 

9-8 
CFC (COMPARE AND FORM CODEWORD) instruc- 
tion 7-15 
CH (COMPARE HALFWORD) instruction 7-20 

example A-13 
chaining check (subchannel status) 

16-32 
chaining of CCWs 15-27 

command (See command chaining of 

CCWs) 
data (See data chaining of CCWs) 
chaining of CRWs 17-16,17-17 
change bit in storage key 3-8 
change recording 3-11 
channel-command word (See CCW) 
channel commands (See commands) 
channel-control check (subchannel 

status) 16-31 
channel-data check (subchannel status) 

16-30 
channel end (device status) 16-25 
channel path 13-1,13-3 

active allegiance for 15-12 
available for selection 15-12 
dedicated allegiance for 15-12 
effect of I/0-system reset on 17-9 
masks in SCHIB (See LPM, LPUM, PAM, 

PIM, PNOM, POM) 
multipath mode of 15-4,15-20 
not operational 16-12 
storing of status for 14-13 
type of 13-5 

working allegiance for 15-11 
channel-path identifier (See CHPID) 
channel-path reset 17-7 

effect of I/0-system reset on 17-10 
channel-path-reset function 15-45 
completion of 15-45 
initiation by RESET CHANNEL PATH 

14-7 
reset signal issued as part of 17-7 
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signaling for 15-45 
channel-path-status word 14-13 
channel program 15-23 

branching in (See TIC) 
execution of 13-6,15-20 
resumption of 14-8 
sequence altered by status modifi- 
er 16-23 
suspension of 13-8,15-33 
serialization 5-32 
suspend control for 15-22 
channel-program address 15-23,16-18 

field-validity flag for in IRB 16-38 
used for IPL 17-12 
channel report 17-16 

generated as a result of RCHP 14-7 
channel report pending 11-17,17-16 

effect of I/0-system reset on 17-10 
subclass-mask bit for 11-24 
channel-report word (See CRW) 
channel subsystem 2-5,13-2 
addressing used in 13-5 
damage 11-18 

effect of I/0-system reset on 17-8 
effect of power-on reset on 4-28 
channel-subsystem monitoring 17-1 

effect of I/0-system reset on 17-10 
channel-subsystem recovery 11-4,17-15 
channel-subsystem timer 17-2 

effect of I/0-system reset on 17-10 
channel-subsystem timing 17-1 
channel-subsystem timing-facility bit 

(in PMCW) 15-4 
characteristic (of floating-point 

number) 9-1 
characters, represented by eight-bit 

code iv 
check bits 3-2,11-2 
check stop 4-3,11-10 

as signal-processor status 4-34 
during manual operation 12-1 
effect on CPU timer 4-23 
entering of 11-13 
indicator 12-2 
malfunction alert for 6-11 
system 11-11 
checking block 11-2 
checking-block code (See CBC) 
checkpoint 11-3 

checkpoint synchronization 11-3 
action 11-4 
operations 11-4 
CHPID (channel-path identifier) 13-5 
in PMCW 15-7 

used in RESET CHANNEL PATH 14-7 
CL (COMPARE LOGICAL) instruction 7-21 
CLC (COMPARE LOGICAL) instruction 7-21 

example A-13 
CLCL (COMPARE LOGICAL LONG) instruction 
7-22 

example A-14 
clear function 15-13 

bit in SCSW for 16-13 
completion of 15-14 
initiated by CLEAR SUBCHANNEL 14-3 
path management for 15-13 
pending 16-15 
signaling for 15-14 
subchannel modification by 15-14 
clear reset 4-27 
clear signal 17-7 

issued as part of clear function 
15-14 



CLEAR SUBCHANNEL (CSCH) instruction 
14-3 

(See also clear function) 
effect on device status of 15-15 
function initiated by 15-13 
use of after RESET CHANNEL PATH 14-7 
clearing operation 

by clear-reset function 4-27 
by load-clear key 12-3 
by system-reset-clear key 12-5 
by TEST BLOCK instruction 10-44 
CLI (COMPARE LOGICAL) instruction 7-21 

example A-14 
CLM (COMPARE LOGICAL CHARACTERS UNDER 
MASK) instruction 7-21 
example A-14 
clock (See TOD clock) 
clock comparator 4-21 

external interruption 6-9 
save areas for 3-40 
validity bit for 11-22 
clock unit 4-21 
CLR (COMPARE LOGICAL) instruction 7-21 

example A-14 
code 

ASCII, handled by architecture iv 

checking-block (See CBC) 

command (in CCW) (See command code 

in CCW) 
condition (See condition code) 
decimal digit and sign 8-2 
deferred condition (I/O) 16-8 
EBCDIC 

chart for G-l 
handled by architecture iv 
eight-bit, handled by architecture 

i v 
error-recovery (I/O) 17-17 
exception-extension 6-13 
external-damage 11-22 

validity bit for 11-20 
I/O-i nterrupti on subclass 15-3 
instruction-length (See ILC) 
interruption (See interruption code) 
monitor (See monitor code) 
operation 5-2 
PER (See PER code) 
report i ng-source (I/O) 17-17 
storage-access (in subchannel logout) 

16-38 
version 10-42 
codeword (for sorting operations) 7-15 
command chaining of CCWs 15-30 

effect of status modifier on 15-30 
flag in CCW for 15-24 
overview of 13-8 
command code in CCW 15-25 
(See also commands) 
invalid 16-29 
command reject (bit in I/O sense data) 

15-39 
command retry 15-42 

effect on PCI of 15-32 
status modifier used for 16-23 
commands (I/O) 15-25,15-35 
control 15-38 

initial read (for IPL) 15-37 
no-operation (control) 15-38 
read 15-37 
read backward 15-37 
sense 15-39 
sense ID 15-41 
transfer in channel 15-42 
write 15-36 
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common-segment bit 3-24 

COMPARE (CCR) binary instructions 7-14 
COMPARE (CD,CDR,CE,CER) floating-point 
instructions 9-8 
examples A-37 
COMPARE AND FORM CODEWORD (CFC) instruc- 
tion 7-15 
COMPARE AND SWAP (CS) instruction 7-19 

examples A-40 
COMPARE DECIMAL (CP) instruction 8-5 

example A-31 
COMPARE DOUBLE AND SWAP (CDS) instruc- 
tion 7-19 

examples A-40 
COMPARE HALFWORD (CH) instruction 7-20 

example A-13 
COMPARE LOGICAL (CL,CLC,CLI,CLR) 
instructions 7-21 
examples A-13 
COMPARE LOGICAL CHARACTERS UNDER MASK 
(CLM) instruction 7-21 
example A-14 
COMPARE LOGICAL LONG (CLCL) instruction 
7-22 

example A-14 
compari son 

address (See address comparison) 
between System/370 and 370-XA modes 

D-l 
decimal 8-5 

example A-31 
floating-point 9-8 

examples A-37 
logical 7-4 

examples A-13 
si gned-binary 7-4 
TOD-clock 4-22 
compatibility 1-3 

among systems in different architec- 
tural modes 1-4 
among systems in the same architec- 
tural mode 1-3 
between 370-XA and System/370 I/O 

operations 13-1 
control program 1-4 
problem state 1-4 
completi on 

of instruction execution 5-11 
of unit of operation 5-12 
completion of I/O functions 

by channel-path reset function 15-45 
by clear function 15-14 
by halt function 15-16 
during data transfer 15-43 
during initiation 15-42 
for immediate commands 15-43 
conceptual sequence 5-22 

as related to storage-operand 
accesses 5-30 
conclusion of I/O operations 13-7/16-1 
during data transfer 15-43 
during initiation 15-42 
for immediate commands 15-43 
conclusion of instruction execution 

5-11 
concurrency of access for storage refer- 
ences 5-29 
condition code 4-6 
deferred 16-8 
in PSW 4-6 
summary C-l 

tested by BRANCH ON CONDITION 
instruction 7-12 



used for decision making 5-7 
validity bit for 11-20 
conditional swapping instructions (See 
COMPARE AND SWAP instruction, COMPARE 
DOUBLE AND SWAP instruction) 
conditions for interruption (See inter- 

rupti on) 
configuration 2-2 
of storage 3-4 
configuration-alert facility (I/O) 

17-14 
connective (See logical connective) 
consistency (storage operand) 5-28 

examples A-44,A-47 
console device 12-1 
control 4-2 

as an I/O command 15-38 
instructions 10-1 
manual (See manual operation) 
control-program compatibility 1-4 
control register 2-3,4-6 

comparison, 370-XA with System/370 

D-7 
save areas 3-41 
validity bit 11-21 
control-register assignment 4-7 

(CRx.y indicates control register x, 

bit position y) 
CR0.1: 

SSM-suppressi on-control bit 
6-22,10-40 
CR0.2: 

TOD-clock-sync-control bit 
4-19,4-21 
CR0.3: 

low-address-protecti on-control bi t 
3-11 
CR0.4: 

extracti on-authori ty-control bit 
5-16 
CR0.5: 

secondary-space-control bit 
3-23,5-16 
CR0.6: 

fetch-protecti on-overri de-control 
bit 3-10 
CR0.8-12: 

translation format 3-23 
CR0.14: 

vectoi — control bit 4-8 
CR0.16: 

malfunction-alert subclass-mask 
bit 6-11 
CR0.17: 

emergency-signal subclass-mask bit 
6-10 
CR0.18: 

external-call subclass-mask bit 
6-10 
CR0.19: 

TOD-clock sync-check subclass-mask 
bit 6-11 
CR0.20: 

clock-comparator subclass-mask bit 
6-10 
CR0.21: 

CPU-timer subclass-mask bit 6-10 
CR0.22: 

service-signal subclass-mask bit 
6-11 
CR0.25: 

i nterrupt-key subclass-mask bit 
6-11 
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CR1.0: 

space-swi tch-event-contrsl bit 
3-23,6-22 
CR1.1-19: 

primary segment-table origin 
(PSTO) 3-24 
CR1. 25-31: 

primary segment-table length 
(PSTL) 3-24 
CR3.0-15: 

PSW-key mask (PKM) 5-16 
CR3. 16-31: 

secondary ASN (SASN) 3-14 
CR4.0-15: 

authorization index (AX) 
3-18,5-17 
CR4. 16-31: 

primary ASN (PASN) 3-14 
CR5.0: 

subsystem-linkage-control bit 
5-17,5-19 
CR5.1-24: 

linkage-table origin (LTO) 5-19 
CR5 .25-31 : 

iinkage-table length (LTD 5-19 
CR6.0-7: 

I/O-interruption subclass mask 
6-12 
CR7.1-19: 

secondary segment-table origin 
(SSTO) 3-24 
CR7. 25-31: 

secondary segment-table length 
(SSTL) 3-24 
CR8. 16-31: 

monitor-mask bits 6-18 
CR9.0: 

PER successful-branching-event- 
mask bit 4-11 
CR9.1: 

PER instruction-fetching-event- 
mask bit 4-11 
CR9.2: 

PER storage-alterati on-event-mask 
bit 4-11 
CR9.3: 

PER general-register-alteration- 
event-mask bit 4-11 
CR9.16-31: 

PER general-register-mask bits 
4-11 
CR10.1-31: 

PER starting address 4-11 
CR11.1-31: 

PER ending address 4-11 
CR12.0: 

branch-trace-control bit 4-8 
CR12.1-29: 

trace-entry address 4-8 
CR12.30: 

ASN-trace-control bit 4-8 
CR12.31: 

explicit-trace-control bit 4-9 
CR14.3: 

channel-report-pendi ng 
subclass-mask bit 11-24 
CR14.4: 

recovery subclass-mask bit 11-24 
CR14.5: 

degradation subclass-mask bit 
11-24 
CR14.6: 

external-damage subclass-mask bit 
11-24 



CR14.7: 

warning subclass-mask bit 11-24 
CR14.12: 

ASN-translati on-control bit 
3-14,5-17 
CR14. 13-31: 

ASN-first-table origin (AFTO) 
3-15 
control unit 2-5,13-4 

effect of I/0-system reset on 17-8 
model number of (from sense-ID 

command) 15-41 
sharing of 13-4 
type number of (from sense-ID 

command) 15-41 
type of 15-13 
control unit busy 16-24,16-25 
control-unit end (device status) 16-24 
conversi on 

binary-to-decimal 7-24 

example A-16 
decimal-to-binary 7-23 

example A-16 
f loati ng-poi nt-number 
basic example A-7 
examples with instructions A-38 
CONVERT TO BINARY (CVB) instruction 
7-23 

example A-16 
CONVERT TO DECIMAL (CVD) instruction 
7-24 

example A-16 
count field 

in CCW 15-25 

invalid 16-29 
in SCSW 16-33 
counter updating (example) A-41 
counting operations 7-13 
CP (COMPARE DECIMAL) instruction 8-5 

example A-31 
CPA (See channel-program address) 
CPU (central processing unit) 2-2 
address 4-29 

assigned storage locations for 

3-39 
when stored during external inter- 
ruptions 6-9 
checkpoint 11-3 

effect of powei — on reset on 4-28 
hangup due to string of interruptions 

4-3 
identification (ID) 10-42 
model number 10-42 
registers 2-2 

save areas for 3-40 
reset 4-26 

signal-processor order 4-31 
retry 11-3 
serialization 5-31 
signaling 4-30 
state 4-2 

check-stop 4-3 
load 4-3 

no effect on TOD clock 4-18 
operating 4-2 
stopped 4-2 
version code 10-42 
CPU timer 4-22 

external interruption 6-10 
save areas for 3-40 
validity bit for 11-22 
CR (See control register) 
CR (COMPARE) binary instruction 7-14 
CRW (channel-report word) 17-17 
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chaining of 17-16*17-17 

error-recovery code (ERC) in 17-17 

overflow in 17-17 

reporti ng-source code (RSC) in 17-17 

reporti ng-source ID (RSID) in 17-18 

solicited 17-17 

storing of 14-14 
CS (COMPARE AND SWAP) instruction 7-19 

examples A-40 
CSCH (See CLEAR SUBCHANNEL instruction) 
current CCW 15-24 

(See also CCW) 
current PSW 4-3,5-6 

(See also PSW) 

stored during interruption 6-2 
CVB (CONVERT TO BINARY) instruction 
7-23 

example A-16 
CVD (CONVERT TO DECIMAL) instruction 
7-24 

example A-16 



D (DIVIDE) binary instruction 7-24 

example A-16 
D field of instruction 5-5 
damage 

channel-subsystem 11-18 
code (external) 11-22 

validity bit for 11-20 
external 11-16 

subclass-mask bit for 11-24 
instruction-processing 11-15 
processing 11-18 
service-processor 11-17 
system 11-15 
timing-facility 11-16 
DAT (See dynamic address translation) 
DAT mode (bit in PSW) 4-5 

use in address translation 3-22 
data 

blocking of (I/O) 15-21 
format for 

decimal instructions 8-1 
floating-point instructions 9-2 
general instructions 7-2 
indirect addressing of (I/O) 

13-7,15-32 
measurement (I/O) (See measurement 

data) 
prefetching of for I/O operation 
15-26 
data address (I/O) 15-26 
invalid 16-29 

invalid specification of 16-29 
data chaining of CCWs 15-29 
flag in CCW for 15-24 
overview of 13-8 
data check 

bit in I/O sense data 15-40 
measurement-block 16-37 
data exception 6-15 
data streaming (I/O) 13-3 

effect of CCW count on 15-30 
DCTI (device-connect-time interval) 
in ESW 16-42 

in measurement block 17-3 
DD (DIVIDE) floating-point instruction 

9-8 
DDR (DIVIDE) floating-point instruction 
9-8 



DE (DIVIDE) floating-point instruction 

9-8 
decimal 

arithmetic 8-2 

comparison 8-5 

digit codes 8-2 

divide exception 6-16 

instructions 8-1 
examples A-30 

number representation 8-1 
examples A-5 

operand overlap 8-3 

overflow 

exception 6-16 
mask in PSW 4-6 

sign codes 8-2 

tables for conversion to hexadecimal 
F-l 
decimal-to-binary conversion 7-23 

example A-16 
dedicated allegiance 15-12 
deferred condition code 16-8 
degradation (machine-check condition) 
11-17 

subclass-mask bit for 11-24 
degradation, storage (machine-check 

condition) 11-19 
delay in storing 5-27 
delayed access exception (machine-check 

condition) 11-21 
deletion of malfunctioning unit 11-5 
DER (DIVIDE) floating-point instruction 
9-8 

examples A-37 
designati on 

authority-table 3-15 

effective segment-table 3-26 

entry-table 5-19 

linkage-table 5-19 
in AST entry 3-16 

of storage area for data (I/O) 15-26 

page-table 3-24 

primary segment-table 3-23 

secondary segment-table 3-24 

segment-table 3-23 
in AST entry 3-15 
destructive overlap 5-29,7-33 
device 2-5,13-4 

console 12-1 

effect of I/0-system reset on 17-8 
device-active bit 16-15 
device address 13-5 
device busy 16-25 

device-connect-time interval (See DCTI) 
device-connect-time measurement 17-5 

effect of suspension on 15-35 

enable 15-3,17-6 
devi ce-di sconnect-time interval (in 

measurement block) 17-4 
device end (device status) 16-26 
device identifier 13-5 
device model/type (from sense-ID 

command) 15-41 
device-not-ready indication 15-39 
device number 13-5 

assignment of 13-6 

in PMCW 15-4 
device-number valid (bit in PMCW) 15-4 
device-ready indication 

with attention 16-23 

with device end 16-26 

with unit exception 16-28 
device status 16-23 
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field-validity flag for (in subchan- 
nel logout) 16-31,16-38 

with inappropriate bit combination 
16-38 
device status check 16-38 
DIAGNOSE instruction 10-4 
digit codes (decimal) 8-2 
digit selector (in EDIT) 8-7 
di rect-access storage 3-2 
disabling for interruptions 6-5 
disallowed interruptions 6-5 
displacement (in relative addressing) 

5-5 
display (manual controls) 12-2 
DIVIDE (D,DR) binary instructions 7-24 

example A-16 
DIVIDE (DD,DDR,DE,DER,DXR) 
floating-point instructions 9-8 

examples A-37 
DIVIDE DECIMAL (DP) instruction 8-5 

example A-31 
divide exception 

decimal 6-16 

fixed-point 6-17 

floating-point 6-17 
divisible instruction execution 5-23 
doubleword 3-3 
doubleword-concurrent storage references 

5-29 
DP (DIVIDE DECIMAL) instruction 8-5 

example A-31 
DR (DIVIDE) binary instruction 7-24 
dump (standalone) 12-4 
DXR (DIVIDE) floating-point instruction 

9-8 
dynamic address translation (DAT) 3-21 

by LOAD REAL ADDRESS instruction 
10-18 

control of 3-22 

explicit and implicit 3-26 

mode bit in PSW 4-5 

use in address translation 3-22 

sequence of table fetches 5-25 
dynami c-reconnecti on feature 13-3 



E instruction format 5-3 
early exception recognition 6-8 
EBCDIC (Extended Binary-Coded-Decimal 
Interchange Code) 

architecture designed for iv 

character code, chart for G-l 
ECC (error checking and correction) 

11-2 
ECW (extended-control word) 16-44 

indication in SCSW 16-11 
ED (EDIT) instruction 8-6 

examples A-31 
EDIT (ED) instruction 8-6 

examples A-31 
EDIT AND MARK (EDMK) instruction 8-9 

example A-33 
editing instructions 8-3 

(See also ED instruction, EDMK 
i nstructi on) 
EDMK (EDIT AND MARK) instruction 8-9 

example A-33 
effective address 3-5 

controlled by addressing mode 5-5 

generation 5-5 

used for storage interlocks 5-23 



effective segment-table designation 

3-26 
EKM (entry key mask) 5-20 
emergency signal (external interruption) 
6-10 

signal-processor order 4-30 
enabled (bit in PMCW) 15-3 
enabling for interruptions 6-5 

subchannel 16-5 
enabling of subchannel 15-3,16-5 
ending of instruction execution 5-11 
entry (for tracing) 4-9 
entry index (EX) 5-18 
entry table (ET) 5-19 

designation 5-19 
EPAR (EXTRACT PRIMARY ASN) instruction 

10-5 
epoch (for TOD clock) 4-20 
equipment check 

bit in I/O sense data 15-39 

in signal-processor status 4-34 
ERC (error-recovery code) 17-17 

(See also CRW) 
error 

checking and correction 11-2 

from DIAGNOSE instruction 10-5 

I/0-error alert 16-39 

indirect storage 11-21 

intermittent 11-5 

PSW-format 6-8 

secondary (I/O) 16-38 

solid 11-5 

state of TOD clock 4-19 

storage 11-19 

storage-key 11-19 
error-recovery code (ERC) 17-17 

(See also CRW) 
ERW (extended-report word) 16-36,16-41 

as result of channel-control check 
16-31 

as result of channel-data check 
16-31 
ESAR (EXTRACT SECONDARY ASN) instruction 

10-5 
ESW (extended-status word) 16-36 

(See also extended status) 
ESW format bit (in SCSW) 16-8 
ET (entry table) 5-19 
ETL (entry-table length) 5-19 
ETO (entry-table origin) 5-19 
event 6-12 

monitor 7-30 

PER 4-11 

space-switch 6-22 
EX (entry index) 5-18 

translation exception 6-17 
EX (EXECUTE) (See EXECUTE instruction) 
exception-extension code 6-13 
exceptions 6-12 

access (collective 
program-interruption name) 
6-25,6-29 

addressing 6-13 

AFX-translation 6-15 

ASN-translati on (collective 
program-interruption name) 6-31 

ASN-translati on- spec if i cation 6-15 

ASX-translation 6-15 

data (decimal) 6-15 

decimal-divide 6-16 

decimal-overflow 6-16 

delayed access (machine-check condi- 
tion) 11-21 

during translation 3-30 
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EX-translati on 6-17 

execute 6-16 

exponent-overflow 6-16 

exponent-underflow 6-16 

fixed-point-divide 6-17 

fixed-point-overflow 6-17 

floating-point-divide 6-17 

LX-translati on 6-17 

operand (of I/O instruction) 6-18 

operation 6-19 

page-translation 6-19 

PC-translati on- spec i f i cati on 6-19 

primary-authority 6-20 

privileged-operation 6-20 

protection 6-21 

PSW-related 6-8 

recognition of, early and late 6-8 

secondary-authority 6-21 

segment-translation 6-21 

significance 6-22 

special-operation 6-22 

specification 6-23 

trace (collective 
program-interruption name) 6-31 

trace-table 6-24 

translation-specification 6-24 

unnormali zed-operand 6-24 

vectoi — operation 6-25 
EXCLUSIVE OR (X,XC,XI,XR) instructions 
7-25 

examples A-17 
EXECUTE (EX) instruction 7-26 

effect of address comparison on 12-1 

example A-18 

exceptions while fetching target 6-7 

PER event for target of 4-14 
execute exception 6-16 

exigent machine-check conditions 11-11 
explicit address translation 3-26 
explicit-trace-control bit 4-9 
exponent 9-1 

(See also floating point) 

overflow 9-1 

exception 6-16 

underflow 9-1 

exception 6-16 
mask in PSW 4-6 
extended control (bit in SCSW) 16-11 
extended-control word (See ECW) 
extended floating-point number 9-2 
extended-report word (See ERW) 
extended status 

(See also ESW) 

flags in subchannel logout for 16-36 

format-0 16-36 

format-1 16-41 

format-2 16-41 

format-3 16-42 
extended-status word 16-36 

(See also extended status) 
extended-status-word-format bit 16-8 
external call 

external interruption 6-10 

pending (signal-processor status) 
4-34 

signal-processor order 4-30 
external damage 11-16 

subclass-mask bit for 11-24 
external-damage code 11-22 

assigned storage locations for 3-41 

validity bit for 11-20 
external interruption 6-9 

clock-comparator 4-22,6-9 

CPU-timer 4-22,6-10 



direct conditions 6-9 

emergency-signal 6-10 

external-call 6-10 

interrupt-key 6-10 

malfunction-alert 6-11 

mask in PSW 4-5 

parameter 6-9 

assigned storage locations for 
3-39 

pending conditions 6-9 

priority of conditions 6-9 

service-signal 6-11 

TOD-clock-sync-check 6-11 
externally initiated functions 4-23 

I/O 17-11 
EXTRACT PRIMARY ASN (EPAR) instruction 

10-5 
EXTRACT SECONDARY ASN (ESAR) instruction 

10-5 
extracti on -authori ty-control bit 5-16 



facilities of 370-XA (compared with 
System/370 mode) D-l 
I/O 13-1 
failing-storage address 11-23 

assigned storage locations for 3-41 
in ESW 16-36,16-41 

as result of channel-control check 

16-31 
as result of channel-data check 
16-31 
validity bit for 11-20 
validity flag for (in ERW) 16-41 
failure, vector-facility 11-17 
fetch protection 3-9 

bit in storage key 3-8 
overri de-control bit 3-10 
fetch reference 5-26 

access exceptions for 6-25 
fetchi ng 

handling of invalid CBC in storage 

keys during 11-8 
of DAT-table entries 5-25 
of instructions 5-24 
of PSWs during interruptions 5-30 
of storage operands 5-26 
field 3-2 

field separator (in EDIT) 8-7 
field-validity flags (in subchannel 
logout) 16-38 

relation to channel-control check of 
16-31 
FIFO (first in first out) queuing, exam- 
ple for lock and unlock A-44 
fill byte (in EDIT) 8-6 
fixed-length field 3-2 
fixed logout 

assigned storage locations for 3-41 
machine-check 11-24 
fixed point 

(See also binary) 
divide exception 6-17 
overflow exception 6-17 
mask in PSW 4-6 
floating interruption conditions 
6-6,11-23 

clearing of 4-27 
floating point 

(See also exponent) 
comparison 9-8 
conversion 
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basic example A-7 
examples with instructions A-38 
data format 9-2 
divide exception 6-17 
instructions 9-1 
examples A-36 
numbers 9-1 

examples A-5 
registers 2-3 

save areas for 3-41 
validity bit for 11-20 
shifting (See normalization) 
format 

address 3-2 

CCW (See CCW format control) 
decimal data 8-1 
floating-point data 9-2 
general data 7-2 
information 3-2 
instruction 5-2 
PSW 4-5 
format-0 and format-1 CCWs 15-24 
fraction 9-1 
free-pool manipulation, programming 

example A-45 
fullword (See word) 
function control (I/O) 16-12 
function-pending time 17-2 
in measurement block 17-3 



G (giga) iv 

general instructions 7-2 
examples A-8 

general registers 2-3 

alteration-event-mask bit 4-11 
alteration of (PER event) 4-15 
PER-mask bits 4-11 
save areas for 3-41 
validity bit for 11-20 

glue module 5-9 

guard digit 9-3 



H 

halfword 3-3 

halfword-concurrent storage references 

5-29 
halt function 15-15 

bit in SCSW for 16-12 

completion of 15-16 

initiated by HALT SUBCHANNEL 14-4 

path management for 15-15 

pending 16-14 

signaling for 15-16 
halt signal 17-7 

issued as part of halt function 
15-16 
HALT SUBCHANNEL (HSCH) instruction 14-4 

(See also halt function) 

effect on SCSW count field 15-18 

function initiated by 15-15 

use of after RESET CHANNEL PATH 14-7 
HALVE (HDR,HER) instructions 9-10 

example A-38 
HDR (HALVE) instruction 9-10 

example A-38 
HER (HALVE) instruction 9-10 
hexadecimal (hex) representation 5-4 

tables F-l 
high-speed data transfer (I/O) 13-3 



HSCH (See HALT SUBCHANNEL instruction) 



I field of instruction 5-4 
I/O (input/output) 2-5 

basic functions of 15-2 

blocking of data for 15-21 

comparison of 370-XA with System/370 
D-7,13-1 

effect on CPU timer 4-22 

error, with machine check 11-5 

mask in PSW 4-5 

sense data (See sense data) 

support functions of 17-1 
I/O addressing 13-5 
I/O commands (See commands) 
I/O device (See device) 
I/0-error alert (in subchannel logout) 

16-39 
1/0 instructions 14-1,14-2 

deferred condition code for 16-8 

operand access by 14-1 

role of in I/O operations 13-6 
I/O interface (OEMI) v 
I/O interruption 6-11,16-1 

(See also interruption) 

action for 16-5 

masking of 13-9 

priority of 16-4 

program-controlled interruption (See 
PCI) 
I/O-i nterrupti on code 6-12,14-15 

stored by TPI 16-6 
I/O-interruption condition 13-9,16-2 

alert 16-4 

intermediate 16-4 

primary 13-7,16-4 

secondary 13-7,16-4 

solicited 16-3 

unsolicited 16-3 
I/O-interruption parameter 

assigned storage locations for 3-40 

in I/O-interruption code 16-6 

in ORB 15-22 

in PMCW 15-3 

used for IPL 17-12 
I/O-interruption request 

clearing of 13-9 

from subchannels 16-5 
I/O-interruption subclass 13-9 
I/O-interruption subclass code (ISC) 

15-3 
I/O-interruption subclass mask 
6-12,16-5 

relation to priority 16-4 
I/O operations 13-6 

conclusion of (See conclusion of I/O 
operations) 

execution of 15-20 

immediate 15-43 

initiated indication for 16-11 

termination of (See conclusion of 
I/O operations) 
I/0-system reset 17-8 

as part of subsystem reset 4-27 
IAC (INSERT ADDRESS SPACE CONTROL) 

instruction 10-6 
IC (INSERT CHARACTER) instruction 7-27 
IC (instruction counter) (See instruc- 
tion address) 
ICM (INSERT CHARACTERS UNDER MASK) 
instruction 7-27 
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examples A-19 
ID (See CPU identification, sense ID) 
IDA (indirect-data address) 15-32 

flag in CCW 15-25 
IDAW (indirect-data-address word) 15-32 

check (in subchannel logout) 16-37 

contents of 15-33 

invalid address of 16-29 

invalid address specification in 
16-29 

invalid address specification of 
16-29 
idle state for subchannel 16-13 
IFCC (interface-control check) 16-32 
ILC (instruction-length code) 6-6 

assigned storage locations for 3-39 

for program interruptions 6-12 

for supervisoi — call interruption 
6-32 
IML (initial microprogram loading) 

controls 12-3 
immediate operand 5-4 
immediate operation (I/O) 15-43 
implicit address translation 3-26 
incorrect length (subchannel status) 
16-28 

for immediate operations 15-38 

when writing undefined blocks 15-36 
incorrect-length-indication mode 15-23 
i ncorrect-length-i ndi cati on-suppressi on 

facility D-2, 17-15 
incorrect-length-suppression mode 15-23 
incorrect state (signal-processor 

status) 4-34 
i ndex 

for address generation 5-5 

instructions for branching on 7-14 

into ASN first and second tables 
3-14 

into authority table 5-17 

into entry and linkage tables 5-18 

into measurement-block area (I/O) 
17-4 

register for 2-3 
indi cator 

check-stop 12-2 

load 12-3 

manual 12-3 

mode 12-2 

test 12-5 

wait 12-5 
indirect-data address (See IDA) 
indirect-data-address word (See IDAW) 
indirect storage error 11-21 
information format 3-2 
inhibition of unit of operation 5-12 
initial CPU reset 4-27 

signal-processor order 4-31 
initial-microprogram-loading (IML) 

controls 12-3 
initial program loading (See IPL) 
i ni t ial -status- inter rupti on control 
15-22,16-11 

relation to Z bit 16-11 

used for IPL 17-12 
inoperative (signal-processor status) 

4-34 
input/output (See I/O) 
INSERT ADDRESS SPACE CONTROL (1AC) 

instruction 10-6 
INSERT CHARACTER (IC) instruction 7-27 
INSERT CHARACTERS UNDER MASK (ICM) 
instruction 7-27 

examples A-19 



INSERT PROGRAM MASK (IPM) instruction 

7-27 
INSERT PSW KEY (IPK) instruction 10-7 
INSERT STORAGE KEY EXTENDED (ISKE) 

instruction 10-7 
INSERT VIRTUAL STORAGE KEY (IVSK) 

instruction 10-7 
installation 2-2 
instruction address 

as a type of address 3-5 
handling by DAT 3-22 
in entry-table entry 5-20 
in PSW 4-6 

validity bit for 11-20 
instruction-length code (See ILC) 
instruction-processing damage 11-15 

resulting in processing backup 11-18 
resulting in processing damage 11-18 
i nstructi ons 

(See also instruction lists and page 

numbers in Appendix B) 
backing up of 11-18 
classes of 2-2 
comparison of 370-XA with System/370 

D-4 
control 10-1 
damage to 11-15,11-18 
decimal 8-1 

examples A-30 
divisible execution of 5-23 
ending of 5-11 
examples of use A-7 
execution of 5-6 
fetching of 5-24 

access exception for 6-25 
PER event for 4-14 
PER-event mask for 4-11 
floating-point 9-1 

examples A-36 
format of 5-2 
general 7-2 

examples A-8 
I/O (See I/O instructions) 
interrupti ble (See interrupti ble 

i nstructi ons) 
length of 5-3 
list of B-l 
modification by EXECUTE instruction 

7-26 
prefetching of 5-25 
privileged 4-5 

for control 10-1 
semipri vi leged 4-5,10-1 
sequence of execution 5-2 
stepping of (rate control) 12-4 
effect on CPU state 4-2 
effect on CPU timer 4-23 
unprivileged 4-5,7-2 
vector 2-5 
integer 

binary 7-2 

address as 5-5 
examples A-2 
decimal 8-2 
integral boundary 3-3 
interface, I/O v 
interface-control check (subchannel 

status) 16-32 
i nterlocked-update storage reference 

5-27 
interlocks for virtual storage refer- 
ences 5-23 
intermediate interruption condition 
(I/O) 16-4 
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intermediate-status bit (I/O) 16-17 
intermittent errors 11-5 
internal storage 2-2 
interrupt key 12-3 

external interruption 6-10 
i nterrupti ble instructions 5-11 

COMPARE AND FORM CODEWORD 7-15 

COMPARE LOGICAL LONG 7-23 

MOVE LONG 7-33 

PER event affecting the ending of 
4-13 

stopping of 4-2 

TEST BLOCK 10-45 

UPDATE TREE 7-49 

vector instructions 5-11 
interruption 6-2 

(See also masks) 

action 6-2 
I/O 16-5 
machine-check 11-12 

classes of 6-5 

effect on instruction sequence 5-11 

external (See external interruption) 

I/O (See I/O interruption) 

machine-check (See machine-check 
i nterrupti on) 

masking of 6-5 

pending 6-5 

external 6-9 
machine-check 11-13 
relation to CPU state 4-2 

priority of (See priority) 

program (See program interruption) 

program-controlled (I/O) (See PCI) 

restart 6-31 

string (See string of interruptions) 

supervisoi — call 6-31 
interruption code 6-5 

external 6-9 

I/O (See I/O-i nterrupt ion code) 

machine-check (MCIC) 3-40,11-14 

program 6-12 

summary of 6-2 

supervisoi — call 6-32 
interruption conditions 6-2 

clearing of 4-26 

floating 6-6,11-23 

I/O (See I/O-i nterruption condition) 
interruption parameter 

external (assigned storage locations) 
3-39 

I/O (See I/O-interruption parameter) 
interruption-response block (See IRB) 
interruption subclass (See 
I/O-interruption subclass) 
intervention required (bit in I/O sense 

data) 15-39 
i nvali d 

address 6-13 

bit in ASN-f i rst-table entry 3-15 

bit in ASN-second-table entry 3-15 

bit in linkage-table entry 5-19 

bit in page-table entry 3-25 

bit in segment-table entry 3-24 

CBC 11-2 

in registers 11-9 

in storage 11-6 

in storage keys 11-7 

operation code 6-19 

order (signal-processor status) 4-34 

parameter (signal-processor status) 
4-34 

translation address 3-30 

translation format 3~23 



exception recognition 3-30 
invalid address specification 

in channel-program address 16-28 
in IDAW 16-29 
of data in CCW 16-29 
of IDAW 16-29 
of TIC CCW 16-28 
invalid CCW field 

command code 16-29 
count 16-29 
data address 16-29 
suspend flag 16-30 
invalid format 
of CCW 16-29 
of ORB 16-30 
invalid sequence, of CCWs 16-30 
INVALIDATE PAGE TABLE ENTRY (IPTE) 
instruction 10-8 

effect of when CPU i s stopped 4-2 
inverse move (See MOVE INVERSE instruc- 
tion, move-inverse facility) 
IPK (INSERT PSW KEY) instruction 10-7 
IPL (initial program loading) 
4-28,17-11 

assigned storage locations for 3-38 
effect on CPU state 4-3 
IPM (INSERT PROGRAM MASK) instruction 

7-27 
IPTE (INVALIDATE PAGE TABLE ENTRY) 

instruction 10-8 
IRB (interruption-response block) 16-6 
(See also ECW, ERW, ESW, SCSW) 
storage requirements for 16-11 
ISC (I/O-interruption subclass code) 

15-3 
ISKE (INSERT STORAGE KEY EXTENDED) 

instruction 10-7 
IVSK (INSERT VIRTUAL STORAGE KEY) 
instruction 10-7 



K (kilo) iv 
key 

access (See access key) 

manual (See manual operation) 

PSW (See PSW key) 

storage (See storage key) 

subchannel (See subchannel key) 
key check (in subchannel logout) 16-36 
key-controlled protection 3-9 

exception for 6-21 
key mask 

authorization 5-19 

entry 5-20 

PSW (PKM) 5-16 



L (LOAD) binary instruction 7-28 

example A-20 
L fields of instruction 5-4 
LA (LOAD ADDRESS) instruction 7-28 

examples A-20 
LASP (LOAD ADDRESS SPACE PARAMETERS) 

instruction 10-10 
last-path-used mask (See LPUM) 
late exception recognition 6-8 
LCDR (LOAD COMPLEMENT) floating-point 

instruction 9-11 
LCER (LOAD COMPLEMENT) floating-point 

instruction 9-11 
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LCR (LOAD COMPLEMENT) binary instruction 

7-28 
LCTL (LOAD CONTROL) instruction 10-17 
LD (LOAD) floating-point instruction 

9-10 
LDR (LOAD) floating-point instruction 

9-10 
LE (LOAD) floating-point instruction 

9-10 
left-to-right addressing 3-2 
length 

field 3-2 
instruction 5-3 
registei — operand 5-4 
second operand same as first 5-4 
variable (storage operand) 5-4 
LER (LOAD) floating-point instruction 

9-10 
LH (LOAD HALFWORD) instruction 7-29 

examples A-20 
LIFO (last in first out) queuing, exam- 
ple for lock and unlock A-43 
light (See indicator) 
limit mode (I/O) 15-3 
link information 

for BRANCH AND LINK instruction 7-10 
for BRANCH AND SAVE AND SET MODE 

instruction 7-11 
for BRANCH AND SAVE instruction 7-11 
linkage for subroutines 5-7 
linkage index (LX) 5-18 
linkage table (LT) 5-19 
designation (LTD) 5-19 

in AST entry 3-16 
length (LTD 5-19 
origin (LTO) 5-19 
LM (LOAD MULTIPLE) instruction 7-29 
LNDR (LOAD NEGATIVE) floating-point 

instruction 9-11 
LNER (LOAD NEGATIVE) floating-point 

instruction 9-11 
LNR (LOAD NEGATIVE) binary instruction 

7-29 
LOAD (L,LR) binary instructions 7-28 

example A-20 
LOAD (LD,LDR,LE,LER) floating-point 

instructions 9-10 
LOAD ADDRESS (LA) instruction 7-28 

examples A-20 
LOAD ADDRESS SPACE PARAMETERS (LASP) 

instruction 10-10 
LOAD AND TEST (LTDR,LTER) floating-point 

instructions 9-11 
LOAD AND TEST (LTR) binary instruction 

7-28 
load-clear key 12-3 
LOAD COMPLEMENT (LCDR,LCER) 

floating-point instructions 9-11 
LOAD COMPLEMENT (LCR) binary instruction 

7-28 
LOAD CONTROL (LCTL) instruction 10-17 
LOAD HALFWORD (LH) instruction 7-29 

examples A-20 
load indicator 12-3 

LOAD MULTIPLE (LM) instruction 7-29 
LOAD NEGATIVE (LNDR, LNER) floating-point 

instructions 9-11 
LOAD NEGATIVE (LNR) binary instruction 

7-29 
load-normal key 12-3 
LOAD POSITIVE (LPDR,LPER) floating-point 

instructions 9-12 
LOAD POSITIVE (LPR) binary instruction 
7-30 



LOAD PSW (LPSW) instruction 10-17 
LOAD REAL ADDRESS (LRA) instruction 

10-18 
LOAD ROUNDED (LRDR,LRER) instructions 

9-12 
load state 4-2,4-3 
during IPL 4-28 
load-unit-address controls 12-3 
loading, initial (See IML, IPL) 
location 3-2 

(See also address) 

not available in configuration 6-13 
lock A-42 

example with FIFO queuing A-45 
example with LIFO queuing A-44 
logi cal 

arithmetic (unsigned binary) 7-3 
comparison 7-4 
connecti ve 
AND 7-9 

EXCLUSIVE OR 7-25 
OR 7-37 
data 7-2 
logical address 3-5 

handling by DAT 3-22 
logical-path mask (See LPM) 
logout 
fixed 

assigned storage locations for 

3-41 
machine-check 11-24 
subchannel (I/O) 16-36 
long floating-point number 9-2 
long I/O block 16-28 
loop control 5-7 
loop of interruptions (See string of 

interrupti ons) 
low-address protection 3-11 
control bit 3-11 
exception for 6-21 
LPDR (LOAD POSITIVE) floating-point 

instruction 9-12 
LPER (LOAD POSITIVE) floating-point 

instruction 9-12 
LPM (logical-path mask) 15-4,15-23 
effect on system performance of 

15-10 
used for IPL 17-12 
LPR (LOAD POSITIVE) binary instruction 

7-30 
LPSW (LOAD PSW) instruction 10-17 
LPUM (last-path-used mask) 15-6 

field-validity flag for (in subchan- 
nel logout) 16-38 
in ESW 16-37 
LR (LOAD) binary instruction 7-28 
LRA (LOAD REAL ADDRESS) instruction 

10-18 
LRDR (LOAD ROUNDED) instruction 9-12 
LRER (LOAD ROUNDED) instruction 9-12 
LT (linkage table) 5-19 
LTD (linkage-table designation) 5-19 
LTDR (LOAD AND TEST) floating-point 

instruction 9-11 
LTER (LOAD AND TEST) floating-point 

instruction 9-11 
LTL (linkage-table length) 5-19 
LTO (linkage-table origin) 5-19 
LTR (LOAD AND TEST) binary instruction 

7-28 
LX (linkage index) 5-18 
invalid bit 5-19 
translation exception 6-17 
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M 

M (mega) iv 

M (MULTIPLY) binary instruction 7-36 

example A-24 
machine check 11-2 

(See also malfunction) 

comparison of 370-XA with System/370 

D-9 
interruption 6-12*11-11 
action 11-12 
code (MCIC) 3-40,11-14 
floating conditions 11-23 
mask in PSW 4-5 

subclass masks in control register 
11-24 
logout 11-24 
main storage 3-2 

(See also storage) 

effect of powei — on reset on 4-28 
shared (in multiprocessing) 4-29 
malfunction 11-2 

at channel subsystem 16-31 
at I/O device 16-32 
correction of 11-2 
effect on manual operation 12-1 
from DIAGNOSE instruction 10-5 
indication of 11-5 
malfunction alert (external 
interruption) 6-11 

when entering check-stop state 11-10 
manual indicator 12-3 

(See also stopped state) 
manual operation 12-1 
controls 

address-compare 12-1 
altei — and-di splay 12-2 
IML 12-3 

load-unit-address 12-3 
power 12-3 
rate 12-4 
TOD-clock 12-5 
effect on CPU signaling 4-32 
keys 

interrupt 12-3 
load-clear 12-3 
load-normal 12-3 
restart 12-4 
start 12-4 
stop 12-4 
store-status 12-4 
system-reset-clear 12-5 
system-reset-normal 12-5 
masks 6-5 

(See also I/O interruption, inter- 
rupt i on) 
in BRANCH ON CONDITION instruction 

7-12 
in COMPARE LOGICAL CHARACTERS UNDER 

MASK instruction 7-21 
in INSERT CHARACTERS UNDER MASK 

instruction 7-27 
in PSW 4-5 
in STORE CHARACTERS UNDER MASK 

instruction 7-43 
monitor 6-18 

path-management 15-2,15-23 
PER-event 4-11 
PER general-register 4-11 
program-interruption 6-13 
subclass 

external-interruption 6-9 
I/O-i nterrupt i on (See 

I/O-i nterrupti on subclass mask) 
machine-check-interruption 11-24 



maximum negative number 7-2 

MC (MONITOR CALL) instruction 7-30 

MCIC (machine-check-interruption code) 

3-40,11-14 
MD (MULTIPLY) floating-point instruction 

9-13 
MDR (MULTIPLY) floating-point instruc- 
tion 9-13 

example A-38 
ME (MULTIPLY) floating-point instruction 

9-13 
measurement 

devi ce-connect-time 17-5 
measurement-block update (I/O) 17-2 
measurement block (I/O) 17-2 
data check 16-37 
index 15-6,17-4 
key 17-4 

used as access key 3-10 
multiple use of 15-10 
origin 17-4 
program check 16-37 
protection check 16-37 
update enable 15-3,17-5 
update mode 17-5 
measurement data (I/O) 
accumulated 17-2 
effect of CSCH on 14-4 
effect of HSCH on 14-5 
measurement-mode control (I/O) 15-3 
MER (MULTIPLY) floating-point instruc- 
tion 9-13 
message byte (in EDIT) 8-7 
MH (MULTIPLY HALFWORD) instruction 7-37 

example A-24 
microprogram (initial loading of) 12-3 
mode 

addressing (See addressing mode) 
architectural (See architectural 

mode) 
burst (channel-path operation) 13-3 
byte-multiplex (channel-path opera- 
tion) 13-3 
devi ce-connect-time-measurement (I/O) 

17-6 
i ncorrect-length-indi cation 15-23 
i ncorrect-length-suppressi on 15-23 
indicator, architectural 12-2 
measurement-block-update (I/O) 17-5 
multipath (See multipath mode) 
primary-space 3-22 
real 3-22 
requirements for semi pri vi leged 

instructions 5-16 
secondary-space 3-22 
single-path 15-4,15-20 
System/370 (See System/370 mode) 
translation 3-22 
370-XA (See 370-XA mode) 
model number (in CPU ID) 10-42 
MODIFY SUBCHANNEL (MSCH) instruction 

14-6 
MONITOR CALL (MC) instruction 7-30 
monitor-class number 6-18 

assigned storage locations for 3-40 
monitor code 6-18 

assigned storage locations for 3-40 
monitor event 6-18 
monitor masks 6-18 
moni tori ng 

(See also measurement) 
channel-subsystem 17-1 
for PER events (See PER) 
with MONITOR CALL 6-18,7-30 
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MOVE (MVCMVI) instructions 7-31 

examples A-18,A-21 
MOVE INVERSE (MVCIN) instruction 7-31 

example A-22 
move-inverse facility 7-31 
MOVE LONG (MVCL) instruction 7-32 

examples A-22 
MOVE NUMERICS (MVN) instruction 7-35 

example A-23 
MOVE TO PRIMARY (MVCP) instruction 

10-19 
MOVE TO SECONDARY (MVCS) instruction 

10-19 
MOVE WITH KEY (MVCK) instruction 10-20 
MOVE WITH OFFSET (MVO) instruction 7-35 

example A-23 
MOVE ZONES (MVZ) instruction 7-36 

example A-24 
MP (MULTIPLY DECIMAL) instruction 8-10 

example A-34 
MR (MULTIPLY) binary instruction 7-36 

example A-24 
MSCH (MODIFY SUBCHANNEL) instruction 

14-6 
multipath mode 15-4 

entering 15-20 
multiple-access storage references 5-28 
MULTIPLY (M,MR) binary instructions 
7-36 

examples A-24 
MULTIPLY (MD,MDR,ME,MER,MXD,MXDR,MXR) 
floating-point instructions 9-13 

example A-38 
MULTIPLY DECIMAL (MP) instruction 8-10 

example A-34 
MULTIPLY HALFWORD (MH) instruction 7-37 

example A-24 
multiprocessing 4-29 

manual operations for 12-6 

programming considerations for 
A-40, 8-3 

programming examples A-40 

timing-facility interruptions for 
4-21 

TOD clock for 4-18 
multiprogramming examples A-40 
MVC (MOVE) instruction 7-31 

examples A-18,A-21 
MVCIN (MOVE INVERSE) instruction 7-31 

example A-22 
MVCK (MOVE WITH KEY) instruction 10-20 
MVCL (MOVE LONG) instruction 7-32 

examples A-22 
MVCP (MOVE TO PRIMARY) instruction 

10-19 
MVCS (MOVE TO SECONDARY) instruction 

10-19 
MVI (MOVE) instruction 7-31 

example A-21 
MVN (MOVE NUMERICS) instruction 7-35 

example A-23 
MVO (MOVE WITH OFFSET) instruction 7-35 

example A-23 
MVZ (MOVE ZONES) instruction 7-36 

example A-24 
MXD (MULTIPLY) floating-point instruc- 
tion 9-13 
MXDR (MULTIPLY) floating-point instruc- 
tion 9-13 
MXR (MULTIPLY) floating-point instruc- 
tion 9-13 



N 

N (AND) instruction 7-9 
N condition (I/O) 16-12 
NC (AND) instruction 7-9 
near-valid CBC 11-2 

in storage 11-5 
negative zero 

binary 7-2 

decimal 8-3 
example A-5 
new PSW 4-3 

assigned storage locations for 3-38 

fetched during interruption 6-2 
NI (AND) instruction 7-9 

example A-8 
no-operati on 

as an I/O command (control) 15-38 

instruction (BRANCH ON CONDITION) 
7-13 
node (of tree structure) 7-49 
noni nterlocked-update storage reference 

5-27 
nonvolatile storage 3-2 
normalization 9-2 
not operational 

as channel-path state 16-12 

(See also path-not-operational bit 
in SCSW, PNOM) 

as CPU state 4-32 

as TOD-clock state 4-19 
not set (TOD-clock state) 4-19 
NR (AND) instruction 7-9 
nulli f i cati on 

exceptions to 5-14 

for exigent machine-check conditions 
11-11 

of instruction execution 5-11 

of unit of operation 5-12 
numberi ng 

of addresses (byte locations) 3-2 

of bits 3-2 
numbers 

binary 7-2 

examples A-2 

CPU-model 10-42 

decimal 8-1 

examples A-5 

device 13-5 

floating-point 9-1 
examples A-5 
numeric bits 8-1 

moving of 7-35 





(OR) instruction 7-37 
OC (OR) instruction 7-37 

OEMI (original equipment manufacturers* 
information)* I/O interface v 

01 (OR) instruction 7-37 
example A-25 

example of problem with A-40 
old PSW 6-2 

assigned storage locations for 3-38 
one's complement binary notation 7-2 

used for SUBTRACT LOGICAL instruction 
7-45 
op code (See operation code) 
operand 5-2 

access of 5-26 

access of for I/O instructions 14-1 

address generation for 5-5 

exception 6-18 
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immediate 5-4 
length of 5-2 
overlap 

for decimal instructions 8-3 
for general instructions 7-2 
register for 5-4 
sequence of references for 5-26 
storage 5-4 

types of (fetch, store, update) 5-26 
used for result 5-2 
operating state 4-2 
operati on 

code (op code) 5-2 

invalid 6-19 
exception 6-19 
I/O (See I/O operations) 
unit of 5-11 
operation-request block (See ORB) 
operator facilities 2-5,12-1 

basic 12-1 
operator intervening (signal-processor 

status) 4-34 
OR (0,0C,0I,0R) instructions 7-37 

example of problem with OR immediate 

A-40 
examples A-25 
ORB (operation-request block) 15-21 
channel-program address in 15-23 
interruption parameter in 15-22 
invalid 16-30 

logical-path mask (LPM) in 15-23 
orders (I/O) 13-6,15-25 
orders (signal-processor) 4-3tf 

conditions precluding response to 

4-32 
CPU reset 4-31 
emergency signal 4-30 
external call 4-30 
initial CPU reset 4-31 
restart 4-30 
sense 4-30 
set prefix 4-31 
start 4-30 
stop 4-30 

stop and store status 4-30 
store status at address 4-31 
overflow 

binary 7-3 

example A-2 
decimal 6-16 

exponent (See exponent overflow) 
fixed-point 6-17,7-3 
in CRW 17-17 
overlap 

destructive 7-33 
operand 

for decimal instructions 8-3 
for general instructions 7-2 
operation 5-22 
overrun (bit in I/O sense data) 15-40 



PACK (PACK) instruction 7-38 

example A-25 
packed decimal numbers 8-1 

conversion of to zoned format 7-48 

conversion to from zoned format 7-38 

examples A-5 
padding byte 

for COMPARE LOGICAL LONG instruction 
7-22 

for MOVE LONG instruction 7-32 



page 3-22 

page-frame real address (PFRA) 3-25 

page index (PX) 3-22 

page-invalid bit (in page-table entry) 

3-25 
page protection D-2,3-10 
bit for 3-25 
exception for 6-21 
page swapping 3-21 
page table 3-25 

designation 3-24 
length (PTL) 3-25 
lookup 3-29 
origin (PTO) 3-24 
page-translation exception 6-19 

as an access exception 6-25,6-29 
PAM (path-available mask) 15-7 

effect of reconfiguration on 15-10 
effect of resetting on 15-10 
effect on allegiance of 15-11 
parameter 

external-interruption 6-9 

assigned storage locations for 
3-39 
I/O-i nterrupti on (See 

I/O-i nterrupti on parameter) 
register for SIGNAL PROCESSOR 

4-31,10-41 
translation 3-22 
parity bit 11-2 
partial completion of instruction 

execution 5-12 
PASN (primary address-space number) 
3-14 

in trace entry 4-10 
path (See channel path) 
path available for selection 15-12 
path management 13-6 

for clear function 15-13 
for halt function 15-15 
for start function and resume func- 
tion 15-18 
path-management-control word (See PMCW) 
path-management masks 

last-path-used mask (See LPUM) 
logical-path mask (See LPM) 
path-available mask (See PAM) 
path-installed mask (See PIM) 
path-not-operational mask (See PNOM) 
path-operational mask (See POM) 
path-not-operational bit (N) in SCSW 

16-12 
path-not-operational condition 15-4 
pattern (in EDIT) 8-6 
PC (PROGRAM CALL) instruction 10-21 
PC-cp (PROGRAM CALL instruction, to 

current primary) 10-23 
PC number 

in trace entry 4-10 
translation 5-18 
PC-ss (PROGRAM CALL instruction, with 

space switching) 10-23 
PC-translati on- spec i f icati on exception 

6-19 
PCI (program-controlled interruption) 
15-31 

as flag in CCW 15-25 

intermediate interruption condition 

for 16-17 
subchannel status for 16-28 
pending channel reports (effect of 

I/0-system reset on) 17-10 
pending interruption (See interruption 
pendi ng) 
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PER (program-event recording) 4-11 
address 4-12 

assigned storage locations for 
3-40 
code 4-12 

assigned storage locations for 
3-40 
events 4-11 

general-regi ster-alterati on event 
4-15 

mask bits 4-11 
instruction-fetching event 4-14 
masks 

bit in PSW 4-5 
general-register 4-11 
PER-event 4-11 
priority of indication 4-13 
program-interruption condition 6-20 
storage-alteration event 4-15 
storage-area designation 4-14 
ending address 4-11 
starting address 4-11 
wraparound 4-14 
successful-branching event 4-14 
PFRA (page-frame real address) 3-25 
piecemeal steps of instruction execution 

5-23 
PIM (path-installed mask) 15-6 
PKM (PSW-key mask) 5-16 
PMCW (path-management-control word) 
15-2 

channel-path identifiers (CHPID) in 
15-7 
PNOM (path-not-operational mask) 15-4 
effect on POM of 15-11 
indicated in SCSW 16-12 
point of damage 11-14 
point of interruption 5-11 
for machine check 11-13 
POM (path-operational mask) 15-7 

effect on PNOM of 15-11 
POST (SVC), example of routine to bypass 

A-42 
postnormali zati on 9-2 
power controls 12-3 
power-on reset 4-28 
powers of 2, table of E-l 
precision (floating-point) 9-1 
preferred sign codes 8-2 
pref etchi ng 

(See also CCW prefetch control) 
access exceptions not recognized for 

6-25 
channel-control check during 16-31 
channel-data check during 16-31 
handling of invalid CBC in storage 

keys during 11-8 
of DAT-table entries 5-25 
of data for I/O 15-26 
of instructions 5-25 
prefix 3-12 

set by signal-processor order 4-31 
store-status save area for 3-41 
prenormali zati on 9-2 
primary address space 3-13 
primary ASN (PASN) 3-14 
primary authority 3-19 

exception 6-20 
primary interruption condition (I/O) 

16-4 
primary segment table 

designation (PSTD) 3-23 
length (PSTD 3-24 
origin (PSTO) 3-24 



primary-space mode 3-22 
primary-status bit (I/O) 16-18 
primary virtual address 3-5 

effective segment-table designation 
for 3-26 
pri ori ty 

of access exceptions 6-29 

of ASN-translati on exceptions 6-31 

of external-interruption conditions 
6-9 

of I/O interruptions 16-4 

of interruptions (CPU) 6-32 

of PER events 4-13 

of program-interruption conditions 
6-27,6-27 

of trace exceptions 6-31 
privileged instructions 4-5 

control 10-1 

I/O 14-1 
privileged-operation exception 6-20 
problem state 4-5 

bit in entry-table entry 5-20 

compatibility 1-4 
processing backup (synchronous 

machine-check condition) 11-18 
processing damage (synchronous 

machine-check condition) 11-18 
processor (See CPU) 
program 

channel (See channel program) 

exceptions 6-12 

execution of 5-2 

fields of SCHIB modifiable by 15-8 

initial loading of 4-28,17-11 

interruption 6-12 
priority of 6-27 

mask (in PSW) 4-6 

validity bit for 11-20 
PROGRAM CALL (PC) instruction 10-21 

trace entry for 4-10 
program check 

as subchannel status 16-28 

measurement-block 16-37 
program-controlled interruption (I/O) 

(See PCI) 
program-event recording (See PER) 
program events (See PER events) 
program-status word (See PSW) 
PROGRAM TRANSFER (PT) instruction 10-28 

trace entry for 4-10 
protection (storage) 3-8 

during tracing 4-10 

fetch (See fetch protection) 

key-controlled (See key-controlled 
protecti on) 

low-address (See low-address 
protection) 

page (See page protection) 
protection check 

as subchannel status 16-30 

measurement-block 16-37 
protection exception 6-21 

as sn access exception 6-25,6-29 
PSTD (primary segment-table designation) 

3-23 
PSTL (primary segment-table length) 

3-24 
PSTO (primary segment-table origin) 

3-24 
PSW (program-status word) 2-3,4-3 

assigned storage locations for 3-38 

comparison of 370-XA with System/370 
D-7 

current 4-3,5-6 
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stored during interruption 6-2 

exceptions associated with 6-8 

format error 6-8 

in program execution 5-6 

store-status save area for 3-41 

validity bits for 11-20 
PSW key 4-5 

in trace entry 4-10 

mask (PKM) 5-16 

used as access key 3-10 

validity bit for 11-20 
PT (PROGRAM TRANSFER) instruction 10-28 
PT-cp (PROGRAM TRANSFER instruction, to 

current primary) 10-28 
PT-ss (PROGRAM TRANSFER instruction, 

with space switching) 10-28 
PTL (page-table length) 3-25 
PUB (PURGE TLB) instruction 10-33 
PTO (page-table origin) 3-24 
publications, other related documents v 
PURGE TLB (PTLB) instruction 10-33 
PX (page index) 3-22 



Q 

queui ng 

FIFO, example for lock and unlock 

A-44 
LIFO, example for lock and unlock 
A-43 



R field of instruction 5-4 
range (of floating-point numbers) 9-1 
rate control 12-4 

RCHP (See RESET CHANNEL PATH instruc- 
tion) 
read (I/O command) 15-37 
read backward (I/O command) 15-37 
real address 3-4 
real mode 3-22 
real storage 3-5 
receiver check (signal-processor status) 

4-34 
reconfiguration of I/O system 17-13 
recovery 

as class of machine-check condition 
11-11 

channel-subsystem 17-15 

system 11-16 

subclass-mask bit for 11-24 
redundancy 11-2 
reference 

bit in storage key 3-8 

multiple-access 5-28 

recording 3-11 

sequence for storage 5-22 
(See also sequence) 

single-access 5-28 
regi ster 

base-address 2-3 

control 2-3 

designation of 5-4 

floating-point 2-3 

general 2-3 

i ndex 2-3 

prefix 3-12 

save areas 3-40,11-22 

validation of 11-9 



validity bits for 11-20 

vectoi — facility 2-5 
remote operating stations 12-1 
reporti ng-source code (RSC) 17-17 
report i ng-source ID (RSID) 17-18 
repressible machine-check conditions 

11-11 
reset 4-23,17-7 

channel-path 17-7 

clear 4-27 

CPU 4-26 

effect on CPU state 4-2 

effect on TOD clock 4-18 

I/0-system 17-8 

as part of subsystem reset 4-27 

initial CPU 4-27 

power on 4-28 

subsystem 4-27 

summary of functions 4-25 

summary of functions performed by 
manual initiation of 4-24 

system-reset-clear key 12-5 

system-reset-normal key 12-5 
RESET CHANNEL PATH (RCHP) instruction 
14-7 

(See also channel-path-reset 
functi on) 

function initiated by 15-45 
RESET REFERENCE BIT EXTENDED (RRBE) 

instruction 10-33 
reset signal (I/O) 17-7 

in channel-path reset 17-7 

in I/0-system reset 17-8,17-9 

issued as part of RCHP 15-45 
resolut i on 

of clock comparator 4-22 

of CPU timer 4-22 

of TOD clock 4-18 
restart 

interruption 6-31 

key 12-4 

signal-processor order 4-30 
result operand 5-2 
resume function 13-8,15-18 

(See also start function) 

initiated by RESUME SUBCHANNEL 14-8 

path management for 15-18 

pending 16-13 
RESUME SUBCHANNEL (RSCH) instruction 
14-8 

(See also resume function) 

channel-program requirements for 
14-8 

count of in measurement block 17-3 

function initiated by 15-18 
retry 

CPU 11-3 

I/O command (See command retry) 
rounding (decimal) 8-10 

example A-35 
RR instruction format 5-3 
RRBE (RESET REFERENCE BIT EXTENDED) 

instruction 10-33 
RRE instruction format 5-3 
RS instruction format 5-3 
RSC (reporting-source code) 17-17 
RSCH (See RESUME SUBCHANNEL 

i nstruct i on) 
RSID (reporting-source ID) 17-18 
running (state of TOD clock) 4-19 
RX instruction format 5-3 
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S (SUBTRACT) binary instruction 7-44 
S instruction format 5-3 
SAC (SET ADDRESS SPACE CONTROL) instruc- 
tion 10-33 
SAL (SET ADDRESS LIMIT) instruction 

14-9 
sample count (in ESW) 17-3 
SASN (secondary address-space number) 
3-14 

in trace entry 4-10 
save areas for registers 3-40,11-22 
SCHIB (subchannel-information block) 
15-2 

as operand of 

MODIFY SUBCHANNEL 14-6 
STORE SUBCHANNEL 14-14 
model-dependent area in 15-8 
path-management-control word (PMCW) 

in 15-2 
subchannel-status word (SCSW) in 

15-8 
summary of modifiable fields in 15-8 
SCHM (See SET CHANNEL MONITOR instruc- 

ti on) 
SCK (SET CLOCK) instruction 10-34 
SCKC (SET CLOCK COMPARATOR) instruction 

10-35 
SCSW (subchannel-status word) 16-6 
activity-control field in 16-13 
CCW address in 16-18 
count in 16-33 
device-status field in 16-23 
function-control field in 16-12 
in IRB 16-6 
in SCHIB 15-8 

status-control field in 16-16 
subchannel-control field in 16-11 
subchannel-status field in 16-28 
SD (SUBTRACT NORMALIZED) instruction 

9-14 
SDR (SUBTRACT NORMALIZED) instruction 

9-14 
SE (SUBTRACT NORMALIZED) instruction 

9-14 
secondary address space 3-13 
secondary ASN (SASN) 3-14 
secondary authority 3-19 

exception 6-21 
secondary error (in subchannel logout) 

16-38 
secondary interruption condition (I/O) 

16-4 
secondary segment table 

designation (SSTD) 3-24 
length (SSTL) 3-24 
origin (SSTO) 3-24 
secondary-space-control bit 3-23,5-16 
secondary-space mode 3-22 
secondary-status bit (I/O) 16-18 
secondary virtual address 3-5 

effective segment-table designation 
for 3-26 
segment 3-22 
segment index (SX) 3-22 
segment-invalid bit (in segment-table 

entry) 3-24 
segment table 3-24 

designation (STD) 3-23 
effective 3-26 
primary 3-23 
secondary 3-24 
lookup 3-29 
segment-translation exception 6-21 



as an access exception 6-25,6-29 
self-describing block of I/O data 15-30 
semi pri vi leged 

instructions 4-5 

descriptions of 10-1 
program authorization 5-15 

summary of 5-18 
programs 4-5,5-15 
sense 

as I/O command 15-39 
as signal-processor order 4-30 
sense data 15-39 

bus-out check 15-39 
command reject 15-39 
data check 15-40 
equipment check 15-39 
indication of 16-26 
intervention required 15-39 
overrun 15-40 
sense ID (I/O command) 15-41 
sequence 

conceptual 5-22 
instruction-execution 5-2 
of CCWs which is invalid 16-30 
of storage references 5-22 
DAT-table entries 5-25 
instructions 5-24 
operands 5-26 
storage keys 5-26 
sequence code (in subchannel logout) 
16-39 

field-validity flag for 16-38 
SER (SUBTRACT NORMALIZED) instruction 

9-14 
serialization 5-31 

caused by I/O instructions 14-1 
channel-program 5-32 
CPU 5-31 

in completion of store operations 
5-27 
service processor 
damage 11-17 

inoperative (signal-processor status) 
4-34 
service signal 

external interruption 6-11 
subclass-mask bit for 6-11 
SET ADDRESS LIMIT (SAL) instruction 

14-9 
SET ADDRESS SPACE CONTROL (SAC) instruc- 
tion 10-33 
SET CHANNEL MONITOR (SCHM) instruction 
14-10 

effect on measurement modes of 17-1 
SET CLOCK (SCK) instruction 10-34 
SET CLOCK COMPARATOR (SCKC) instruction 

10-35 
SET CPU TIMER (SPT) instruction 10-35 
set prefix (signal-processor order) 

4-31 
SET PREFIX (SPX) instruction 10-36 
SET PROGRAM MASK (SPM) instruction 7-39 
SET PSW KEY FROM ADDRESS (SPKA) instruc- 
tion 10-36 
SET SECONDARY ASN (SSAR) instruction 

10-37 
set state (of TOD clock) 4-19 
SET STORAGE KEY EXTENDED (SSKE) instruc- 
tion 10-40 
SET SYSTEM MASK (SSM) instruction 10-40 
SH (SUBTRACT HALFWORD) instruction 7-45 
shared storage (See storage sharing) 
shared TOD clock 4-18 
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SHIFT AND ROUND DECIMAL (SRP) instruc- 
tion 8-10 

examples A-34 
SHIFT LEFT DOUBLE (SLDA) instruction 
7-39 

example A-26 
SHIFT LEFT DOUBLE LOGICAL (SLDL) 

instruction 7-40 
SHIFT LEFT SINGLE (SLA) instruction 
7-40 

example A-26 
SHIFT LEFT SINGLE LOGICAL (SLL) instruc- 
tion 7-40 
SHIFT RIGHT DOUBLE (SRDA) instruction 

7-41 
SHIFT RIGHT DOUBLE LOGICAL (SRDL) 

instruction 7-41 
SHIFT RIGHT SINGLE (SRA) instruction 

7-41 
SHIFT RIGHT SINGLE LOGICAL (SRL) 

instruction 7-42 
shifting, floating-point (See normal- 

i zati on) 
short floating-point number 9-2 
short I/O block 16-28 
SI instruction format 5-3 
SID (subsystem-identification word) 
14-1 

assigned storage locations for 3-40 
sign bit 

binary 7-2 
floating-point 9-1 
sign codes (decimal) 8-2 
signal (I/O) 17-6 

clear (See clear signal) 
halt (See halt signal) 
reset (See reset signal) 
SIGNAL PROCESSOR (SIGP) instruction 
10-40 

comparison of 370-XA with System/370 

D-9 
orders 4-30 
status 4-33 
signed binary 

arithmetic 7-3 
compari son 7-4 
integer 7-2 

examples A-2 
si gni f i cance 

exception 6-22 
loss 9-2 

in floating-point addition 9-7 
mask (in PSW) 4-6 
starter (in EDIT) 8-7 
SIGP (See SIGNAL PROCESSOR instruction) 
single-access reference 5-28 
single-path mode 15-4,15-20 
size notation iv 
size of address 3-5 

controlled by addressing mode 5-5 
in CCW 15-24 
skip flag in CCW 15-25 

effect on data transfer of 15-31 
SL (SUBTRACT LOGICAL) instruction 7-45 
SLA (SHIFT LEFT SINGLE) instruction 
7-40 

example A-26 
SLDA (SHIFT LEFT DOUBLE) instruction 
7-39 

example A-26 
SLDL (SHIFT LEFT DOUBLE LOGICAL) 

instruction 7-40 
SLI (suppress-length-i ndi cati on) flag in 
CCW 15-36 



for immediate operations 15-38 

SLL (SHIFT LEFT SINGLE LOGICAL) instruc- 
tion 7-40 

SLR (SUBTRACT LOGICAL) instruction 7-45 

solicited interruption condition (I/O) 
16-3 

solid errors 11-5 

sorting instructions (See COMPARE AND 
FORM CODEWORD instruction, UPDATE TREE 
i nstructi on) 

source, vector-facility (machine-check 
condition) 11-18 

source of interruption, identified by 
interruption code 6-5 

SP (SUBTRACT DECIMAL) instruction 8-11 

space-switch event 6-22 
control bit 

in ASTE 3-16 

in control register 1 3-23 

special-operation exception 6-22 

specification exception 6-23 

SPKA (SET PSW KEY FROM ADDRESS) instruc- 
tion 10-36 

SPM (SET PROGRAM MASK) instruction 7-39 

SPT (SET CPU TIMER) instruction 10-35 

SPX (SET PREFIX) instruction 10-36 

SR (SUBTRACT) binary instruction 7-44 

SRA (SHIFT RIGHT SINGLE) instruction 
7-41 

SRDA (SHIFT RIGHT DOUBLE) instruction 
7-41 

SRDL (SHIFT RIGHT DOUBLE LOGICAL) 
instruction 7-41 

SRL (SHIFT RIGHT SINGLE LOGICAL) 
instruction 7-42 

SRP (SHIFT AND ROUND DECIMAL) instruc- 
tion 8-10 

examples A-34 

SS instruction format 5-3 

SSAR (SET SECONDARY ASN) instruction 
10-37 

SSAR-cp (SET SECONDARY ASN instruction, 
to current primary) 10-37 

SSAR-ss (SET SECONDARY ASN instruction, 
with space switching) 10-37 

SSCH (See START SUBCHANNEL instruction) 

SSE instruction format 5-3 

SSKE (SET STORAGE KEY EXTENDED) instruc- 
tion 10-40 

SSM (SET SYSTEM MASK) instruction 10-40 

SSM-suppressi on-control bit 6-22,10-40 

SSTD (secondary segment-table desig- 
nation) 3-24 

SSTL (secondary segment-table length) 
3-24 

SSTO (secondary segment-table origin) 
3-24 

ST (STORE) binary instruction 7-42 

standalone dump 12-4 

standard epoch (for TOD clock) 4-20 

STAP (STORE CPU ADDRESS) instruction 
10-42 

start (CPU) 

function 4-2 

key 12-4 

signal-processor order 4-30 

start function (I/O) 13-6,15-18 
bit in SCSW for 16-12 
initiated by START SUBCHANNEL 14-12 
path management for 15-18 
pending 16-14 

START SUBCHANNEL (SSCH) instruction 
14-12 

(See also start function for I/O) 
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count of in measurement block 17-3 
deferred condition code for (in SCSI*)) 

16-8 
function initiated by 15-18 
operation-request block (ORB) used by 
15-21 
state 

CPU (See CPU state) 
TOD-clock 4-19 
status 

alert 16-16 
device 16-23 

effect of clear function on 15-15 
field-validity flag for (in 

subchannel logout) 16-38 
with inappropriate bit combination 
16-38 
device-status check 16-38 
for SIGNAL PROCESSOR 4-30,10-41 
initial, interruption (See 

i ni tial-status-i nterrupti on control) 
intermediate 16-17 
primary 16-18 
program (See PSW) 
resulting from signal-processor 

orders 4-33 
secondary 16-18 
storing of 4-29 

manual key for 12-4 
subchannel 16-28 
status-control field (in SCSW) 16-16 
status modifier (device status) 16-23 

effect of in command chaining 15-30 
status-pending 16-18 

status-verification facility D-2, 17-14 
status while disabled 14-6 
STC (STORE CHARACTER) instruction 7-42 
STCK (STORE CLOCK) instruction 7-43 
STCKC (STORE CLOCK COMPARATOR) instruc- 
tion 10-42 
STCM (STORE CHARACTERS UNDER MASK) 
instruction 7-42 
examples A-26 
STCPS (STORE CHANNEL PATH STATUS) 

instruction 14-13 
STCRW (See STORE CHANNEL REPORT WORD 

i nstructi on) 
STCTL (STORE CONTROL) instruction 10-42 
STD (segment-table designation) 3-23 
STD (STORE) floating-point instruction 

9-14 
STE (STORE) floating-point instruction 

9-14 
STH (STORE HALFWORD) instruction 7-44 
STIDP (STORE CPU ID) instruction 10-42 
STL (segment-table length) 3-23 
STM (STORE MULTIPLE) instruction 7-44 

example A-27 
STNSM (STORE THEN AND SYSTEM MASK) 

instruction 10-44 
STO (segment-table origin) 3-23 
stop 

function 4-2 
key 12-4 

signal-processor order 4-30 
stop and store status (signal-processor 

order) 4-30 
stopped (signal-processor status) 4-34 
stopped state 
of CPU 4-2 

effect on completion of store 
operations 5-27 
of TOD clock 4-19 



storage 3-2 

absolute 3-4 

address wraparound (See wraparound) 

addressing 3-2 

(See also address) 
alteration manual controls 12-2 
alteration PER event 4-15 

mask for 4-11 
assigned locations in 3-38 
comparison of 370-XA with 
System/370 D-9 
auxiliary 3-2,3-21 
block 3-4 

testing for usability of 10-44 
buffer (cache) 3-2 

clearing of (See clearing operation) 
configuration of 3-4 
di rect-access 3-2 
display 12-2 
error 11-19 

indirect 11-21 
failing address in (See 

failing-storage address) 
interlocked update 5-27 
interlocks for virtual references 

5-23 
internal 2-2 
key 3-8 

error in 11-19 

sequence of references to 5-26 
testing for usability of 10-44 
validation of 11-7 
main 3-2 

noni nterlocked update 5-27 
nonvolatile 3-2 
operand 5-4 

reference to (fetch, store, 

update) 5-26 
update reference 5-27 
operand consistency 5-28 

examples A-44,A-47 
prefixing for 3-12 
real 3-5 

sequence of references to 5-22 
size, notation for iv 
validation of 11-6 
virtual 3-21 
volatile 3-2 

effect of power-on reset on 4-28 
storage-access code (in subchannel 

logout) 16-38 
storage-area designation 

for I/O operations 15-26 
for PER events 4-14 
storage degradation (machine-check 

condition) 11-19 
storage-logical-validity bit 11-21 
storage protection 3-8 
during tracing 4-10 
storage sharing 

by address spaces 3-21 

by CPUs and the channel subsystem 

3-4 
examples A-40 
in multiprocessing 4-29 
STORE (ST) binary instruction 7-42 
STORE (STD, STE) floating-point 

instructions 9-14 
STORE CHANNEL PATH STATUS (STCPS) 

instruction 14-13 
STORE CHANNEL REPORT WORD (STCRW) 
instruction 14-14 

channel-report word (CRW) stored by 
17-17 
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STORE CHARACTER (STC) instruction 7-42 
STORE CHARACTERS UNDER MASK (STCM) 
instruction 7-42 
examples A-26 
STORE CLOCK (STCK) instruction 7-43 
STORE CLOCK COMPARATOR (STCKC) instruc- 
tion 10-42 
STORE CONTROL (STCTL) instruction 10-42 
STORE CPU ADDRESS (STAP) instruction 

10-42 
STORE CPU ID (STIDP) instruction 10-42 
STORE CPU TIMER (STPT) instruction 

10-43 
STORE HALFWORD (STH) instruction 7-44 
STORE MULTIPLE (STM) instruction 7-44 

example A-27 
STORE PREFIX (STPX) instruction 10-43 
store reference 5-27 

access exceptions for 6-25 
store status 4-29 
key 12-4 

signal-processor order for 4-30 
store status at address 

(signal-processor order) 4-31 
STORE SUBCHANNEL (STSCH) instruction 

14-14 
STORE THEN AND SYSTEM MASK (STNSM) 

instruction 10-44 
STORE THEN OR SYSTEM MASK (STOSM) 

instruction 10-44 
STOSM (STORE THEN OR SYSTEM MASK) 

instruction 10-44 
STPT (STORE CPU TIMER) instruction 

10-43 
STPX (STORE PREFIX) instruction 10-43 
string of interruptions 4-3,6-32 
caused by clock comparator 4-22 
caused by CPU timer 4-23 
STSCH (STORE SUBCHANNEL) instruction 

14-14 
SU (SUBTRACT UNN0RMALI2ED) instruction 

9-15 
subchannel 13-2 

active allegiance for 15-12 
dedicated allegiance for 15-12 
effect of I/0-system reset on 17-9 
idle 16-13 

working allegiance for 15-11 
subchannel-active bit 16-15 
subchannel addressing 13-5 
subchannel control information in SCSUi 

16-11 
subchannel enabled bit in PMCW 15-3 
subchannel-information block (See 

SCHIB) 
subchannel key 15-22,16-7 
used as access key 3-10 
used for IPL 17-12 
subchannel key check (in subchannel 

logout) 16-36 
subchannel logout 16-36 
subchannel number 13-5 
subchannel status 16-28 

while disabled 14-6 
subchannel-status word (See SCSUi) 
subclass-mask bits 6-5 

external-interruption 6-9 
I/O-i nterrupti on (See 

I/O-i nterrupti on subclass mask) 
machine-check 11-24 
subroutine linkage 5-7 



subsystem-identification word (See SID) 
subsystem-linkage-control bit 5-17,5-19 
subsystem reset 4-27 
SUBTRACT (S,SR) binary instructions 

7-44 
SUBTRACT DECIMAL (SP) instruction 8-11 
SUBTRACT HALFWORD (SH) instruction 7-45 
SUBTRACT LOGICAL (SL,SLR) instructions 

7-45 
SUBTRACT NORMALIZED (SD,SDR,SE, SER,SXR) 

instructions 9-14 
SUBTRACT UNNORMALIZED (SU,SUR, SW, SWR) 

instructions 9-15 
successful-branching PER event 4-14 

mask for 4-11 
SUPERVISOR CALL (SVC) instruction 7-45 
supervisor-call interruption 6-31 
supervisor state 4-5 
support functions (I/O) 17-1 
suppress-length-i ndication flag in CCW 

(See SLI) 
suppress-suspended-i nterrupti on control 
(I/O) 15-22,16-11 

used for IPL 17-12 
suppress) on 

exceptions to 5-14 

of instruction execution 5-11 

of unit of operation 5-12 
SUR (SUBTRACT UNNORMALIZED) instruction 

9-15 
suspend-control bit 15-22,16-8 

used for IPL 17-12 
suspend flag in CCW 15-25 

invalid 16-30 
suspend function 13-8 
suspended bit (in SCSW) 16-16 
suspension of channel-program execution 
15-33 

effect on DCTI of 15-35 

intermediate interruption condition 
for 16-17 
SVC (SUPERVISOR CALL) instruction 7-45 
SW (SUBTRACT UNNORMALIZED) instruction 

9-15 
swappi ng 

by COMPARE (DOUBLE) AND SWAP 
instructions 7-19 

by EXCLUSIVE OR instruction 7-25 
SWR (SUBTRACT UNNORMALIZED) instruction 

9-15 
SX (segment index) 3-22 
SXR (SUBTRACT NORMALIZED) instruction 

9-14 
synchroni zat i on 

checkpoint 11-3 

of CPU timer with TOD clock 4-22 

of TOD clocks 4-19,4-21 
synchronous machi ne-check-i nterrupti on 

conditions 11-18 
system 

manual control of 12-1 

organization of 2-1 
system check stop 11-11 
system damage 11-15 
system mask (in PSW) 4-3 

validity bit for 11-20 
system recovery 11-16 
system reset (See reset) 

I/O (See I/0-system reset) 
system-reset-clear key 12-5 
system-reset-normal key 12-5 
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System/370 mode 

comparison with 370-XA mode D-l 
compatibility with 370-XA mode 1-4 
selection of 

by architectural-mode controls 

12-2 
by IML controls 12-3 
provided for compatibility 1-4 



T 
tables 

ASN (See ASN first table, ASN second 

table) 
authority (See authority table) 
DAT (See page table, segment table) 
entry (See entry table) 
hexadecimal F-l 
linkage (See linkage table) 
page (See page table) 
powers of 2 E-l 
segment (See segment table) 
trace 4-8 
target instruction 7-26 
TB (TEST BLOCK) instruction 10-44 
termi nati on 

of I/O operations (See conclusion of 

I/O operations) 
of instruction execution 5-11 

for exigent machine-check condi- 
tions 11-11 
of unit of operation 5-13 

for exigent machine-check condi- 
tions 11-11 
termination code (in subchannel logout) 
16-38 

field-validity flag for 16-38 
TEST AND SET (TS) instruction 7-46 
TEST BLOCK (TB) instruction 10-44 
test indicator 12-5 

TEST PENDING INTERRUPTION (TPI) instruc- 
tion 14-15 

interruption code stored by 16-6 
TEST PROTECTION (TPROT) instruction 

10-46 
TEST SUBCHANNEL (TSCH) instruction 
14-16 

interruption-response block (IRB)used 
by 16-6 
TEST UNDER MASK (TM) instruction 7-46 

examples A-27 
testing for storage-block and 
storage-key usability 10-44 
TIC (transfer in channel) 15-42 

invalid sequence of 16-30 
time-of-day clock (See TOD clock) 
timer (See CPU timer) 
timing, channel-subsystem 17-1 
timing facilities 4-18 
timing-facility bit (in PMCW) 15-4 
timing-facility damage 11-16 

for TOD clock 4-19 
TLB (translation-lookaside buffer) 3-30 
entries 3-31 

attachment of 3-31 

clearing of 3-34 

effect of translation changes on 

3-34 
usable state 3-31 
summary 3-32 
TM (TEST UNDER MASK) instruction 7-46 

examples A-27 
TOD clock 4-18 



effect of power-on reset on 4-28 

effect on clock-comparator intei — 
ruption 6-10 

effect on CPU-timer decrementing 
4-23 

effect on CPU-timer interruption 
6-10 

manual control of 4-19,12-5 

unique values of 4-20 

validation of 11-9 

value in trace entry 4-10 
TOD-clock sync check (external inter- 
ruption) 6-11 
TOD-clock-sync-control bit 4-19,4-21 
TOD-clock-synchroni zati on facility 4-21 
TPI (See TEST PENDING INTERRUPTION 

i nstructi on) 
TPROT (TEST PROTECTION) instruction 

10-46 
TR (TRANSLATE) instruction 7-47 

example A-28 
trace D-2,4-8 

entries 4-9 

entry address 4-8 

exceptions 6-31 

table exception 6-24 
TRACE (TRACE) instruction 10-48 

trace entry for 4-10 
transfer in channel (See TIC) 
TRANSLATE (TR) instruction 7-47 

example A-28 
TRANSLATE AND TEST (TRT) instruction 
7-47 

example A-28 
translati on 

address 3-21 

(See also dynamic address trans- 
lati on) 

ASN 3-13 

exception identification 3-40 

format 3-23 

lookaside buffer (See TLB) 

modes 3-22 

parameters 3-22 

PC-number 5-18 

specification exception 6-24 

tables for 3-24 
tree structure for sorting 7-49 
trial execution 

for editing instructions and TRANS- 
LATE instruction 5-15 

for PER 4-12 
TRT (TRANSLATE AND TEST) instruction 
7-47 

example A-28 
true zero (floating-point number) 9-1 
TS (TEST AND SET) instruction 7-46 
TSCH (See TEST SUBCHANNEL instruction) 
two's complement binary notation 7-2 

examples A-2 



U 

underflow (See exponent underflow) 

unit check (device status) 16-26 

in establishing dedicated allegiance 
15-12 

unit exception (device status) 16-27 

unit of operation 5-11 

unlock A-42 

example with FIFO queuing A-45 
example with LIFO queuing A-44 

unnormalized floating-point number 9-2 
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unnormali zed-operand exception 6-24 
UNPACK (UNPK) instruction 7-48 

example A-30 
UNPK (UNPACK) instruction 7-48 

example A-30 
unprivileged instructions 4-5,7-2 
unsigned binary 
arithmetic 7-3 
integer 7-2 

examples A-4 

in address generation 5-5 
unsolicited interruption condition (I/O) 
16-3 



update reference 
UPDATE TREE (UPT) 
UPT (UPDATE TREE) 
usable TLB entry 



5-27 

i nstruct i on 

instruct! on 

3-31 



7-49 
7-49 



valid CBC 11-2 

valid segment-table or page-table entry 

3-31 
validation 11-5 

of registers 11-9 

of storage 11-6 

of storage key 11-7 

of TOD clock 11-9 
validity bits 

in machine-check-interruption code 
11-20 

in subchannel logout 16-38 
variable-length field 3-3 
vector facility 2-5 

effect of power-on reset on 4-28 
vectoi — facility failure (machine-check 

condition) 11-17 
vector-facility source (machine-check 

condition) 11-18 
vector-operation exception 6-25 
version code 10-42 
virtual address 3-5 
virtual storage 3-21 
volatile storage 3-2 

effect of powei — on reset on 4-28 



W 

WAIT (SVC), example of routine to bypass 

A-42 
wait indicator 12-5 
wait state (bit in PSW) 4-5 
warning (machine-check condition) 11-17 

subclass-mask bit for 11-24 
word 3-3 

word-concurrent storage references 5-29 
working allegiance (I/O) 15-11 
wraparound 

of instruction addresses 5-5 



of PER addresses 4-14 
of regi ster numbers 

for LOAD MULTIPLE instruction 

7-29 
for STORE MULTIPLE instruction 
7-44 
of storage addresses 3-6 
comparison of 370-XA with 

System/370 for D-10 
controlled by addressing mode 3-6 
for MOVE INVERSE instruction 7-31 
for MOVE LONG instruction 7-33 
of TOD clock 4-18 
write (I/O command) 15-36 



X (EXCLUSIVE OR) instruction 7-25 

X field of instruction 5-5 

XA (extended architecture) (See 370-XA 

mode) 
XC (EXCLUSIVE OR) instruction 7-25 
examples A-17 

XI (EXCLUSIVE OR) instruction 7-25 
example A-18 

XR (EXCLUSIVE OR) instruction 7-25 



Z bit (zero condition-code bit) 16-11 
as cause of intermediate interruption 
condition 16-17 

ZAP (ZERO AND ADD) instruction 8-12 
example A-36 

zero 

instruction-length code 6-6 
negative (See negative zero) 
normal meaning for byte value v 
true (floating-point number) 9-1 

ZERO AND ADD (ZAP) instruction 8-12 
example A-36 

zero condition code (Z bit in SCSUI) 
16-11 

zone bits 8-1 

moving of 7-36 

zoned decimal numbers 8-1 
examples A-5 



370-XA mode 

architectural-mode controls 12-2 
comparison of facilities with 
System/370 mode D-l 
I/O 13-1 
highlights of 1-1 
IML controls 12-3 
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